# ─── Stage 1: Shared build base (avoids duplicate apk install) ──────────────── FROM rust:1.96-alpine3.24 AS base # sqlx's postgres driver speaks the wire protocol in pure Rust (no pq-sys in # Cargo.lock) and TLS goes through rustls, so libpq headers are never needed at # build time. perl/make/gcc/musl-dev remain for the C builds of aws-lc-sys. RUN apk --no-cache upgrade && \ apk add --no-cache musl-dev pkgconfig gcc perl make # ─── Stage 1b: Build the SvelteKit frontend (Vite) ─────────────────────────── # Produces the SPA in /static-dist. `npm ci` is cached unless the lockfile # changes; the Rust build no longer bundles assets (see build.rs). FROM node:26.3.1-alpine3.24 AS frontend WORKDIR /frontend COPY frontend/package.json frontend/package-lock.json ./ RUN npm ci COPY frontend/ ./ RUN npm run build # ─── Stage 2: Cache dependencies ───────────────────────────────────────────── FROM base AS cacher WORKDIR /app COPY Cargo.toml Cargo.lock ./ # build.rs runs during the dependency build; it only injects git metadata. COPY build.rs ./ # Create a minimal project to download and cache dependencies RUN mkdir -p src/bin && \ echo 'fn main() { println!("Dummy build for caching dependencies"); }' > src/main.rs && \ echo 'fn main() {}' > src/bin/generate-openapi.rs && \ echo 'fn main() {}' > src/bin/migrate-nfc-filenames.rs && \ cargo build --release --bin oxicloud --bin generate-openapi --bin migrate-nfc-filenames && \ rm -rf src static-dist target/release/deps/oxicloud* target/release/build/oxicloud-* # ─── Stage 3: Build the application ────────────────────────────────────────── FROM base AS builder WORKDIR /app # Copy cached dependencies (only target dir and cargo registry) COPY --from=cacher /app/target target COPY --from=cacher /usr/local/cargo/registry /usr/local/cargo/registry # Copy source, build script, and migrations COPY Cargo.toml Cargo.lock build.rs ./ COPY src src COPY migrations migrations # askama templates — read at *compile time* by the derive macro, so # they must be present in the build stage even though they're embedded # into the final binary and never read from disk at runtime. COPY templates templates # Build with all optimizations (DATABASE_URL only needed at compile-time for sqlx) ARG DATABASE_URL="postgres://postgres:postgres@localhost/oxicloud" # Explicit --bin list: defence-in-depth so the prod image never ships # test-only bins (e.g. load-seed) even if `required-features` gating # changes upstream. RUN DATABASE_URL="${DATABASE_URL}" cargo build --release --bin oxicloud --bin generate-openapi --bin migrate-nfc-filenames # The SPA is built by the Vite frontend stage; bring it in for the runtime copy # below (build.rs has no asset pipeline — it only injects git metadata). COPY --from=frontend /static-dist ./static-dist # ─── Stage 4: Minimal runtime image ────────────────────────────────────────── FROM alpine:3.24.0 # OCI image metadata LABEL org.opencontainers.image.title="OxiCloud" \ org.opencontainers.image.description="Ultra-fast, secure & lightweight self-hosted cloud storage built in Rust" \ org.opencontainers.image.url="https://github.com/DioCrafts/OxiCloud" \ org.opencontainers.image.source="https://github.com/DioCrafts/OxiCloud" \ org.opencontainers.image.vendor="DioCrafts" \ org.opencontainers.image.licenses="MIT" # Install only necessary runtime dependencies and update packages # su-exec is needed by the entrypoint to drop privileges after fixing volume permissions. # No libpq: the pure-Rust sqlx postgres driver never links it. RUN apk --no-cache upgrade && \ apk add --no-cache libgcc ca-certificates tzdata su-exec && \ addgroup -g 1001 -S oxicloud && \ adduser -u 1001 -S oxicloud -G oxicloud # Copy the compiled binary and entrypoint (--chmod avoids extra RUN chmod layers) COPY --from=builder --chmod=755 /app/target/release/oxicloud /usr/local/bin/ # Ship the NFC filename migration binary alongside the server so # operators can run it inside the container without a separate Rust # toolchain — `docker exec migrate-nfc-filenames --dry-run` # to preview, drop `--dry-run` to execute. One-shot tool, safe to # ship; it only mutates `storage.files` rows whose name ≠ NFC(name). COPY --from=builder --chmod=755 /app/target/release/migrate-nfc-filenames /usr/local/bin/ COPY entrypoint.sh /usr/local/bin/entrypoint.sh RUN sed -i 's/\r//' /usr/local/bin/entrypoint.sh && \ chmod 755 /usr/local/bin/entrypoint.sh # Copy the built SPA (produced by the Vite frontend stage) COPY --from=builder --chown=oxicloud:oxicloud /app/static-dist /app/static # Create storage directory with proper permissions RUN mkdir -p /app/storage && chown -R oxicloud:oxicloud /app/storage # Allocator tuning — make RSS track the live working set. # mimalloc retains freed pages by default, so process RSS clamps at the peak # even after the in-memory caches (file content, thumbnails, transcode) expire # by TTL. Purging immediately returns those pages to the kernel at no throughput # cost. Measured on this musl/aarch64 image: a 400 MB alloc→free spike returns # 0 MB by default vs ~400 MB with this set (idle RSS back to a few MB). ENV MIMALLOC_PURGE_DELAY=0 # Set working directory WORKDIR /app # Expose application port EXPOSE 8086 # Liveness probe — verifies the HTTP server is up (no DB check, fast). # Docker / Compose / Swarm will mark the container unhealthy after 3 failures. HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \ CMD wget -qO- http://localhost:8086/health || exit 1 # Entrypoint fixes volume permissions then drops to oxicloud user. # The container starts as root so it can chown mounted volumes, # then su-exec drops privileges before running the application. ENTRYPOINT ["entrypoint.sh"] CMD ["oxicloud"]