| # ββ Common base with runtime deps ββββββββββββββββββββββββββββββββββββββββββ | |
| FROM node:24-trixie-slim AS base | |
| WORKDIR /app | |
| RUN --mount=type=cache,target=/var/cache/apt,sharing=shared \ | |
| --mount=type=cache,target=/var/lib/apt/lists,sharing=shared \ | |
| apt-get update \ | |
| && apt-get install -y --no-install-recommends libsecret-1-0 ca-certificates \ | |
| && rm -rf /var/lib/apt/lists/* | |
| # ββ Builder ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ | |
| FROM base AS builder | |
| # Build tools for native module compilation | |
| # apt-get update needed here because base's rm -rf clears the shared cache | |
| RUN --mount=type=cache,target=/var/cache/apt,sharing=shared \ | |
| --mount=type=cache,target=/var/lib/apt/lists,sharing=shared \ | |
| apt-get update \ | |
| && apt-get install -y --no-install-recommends python3 make g++ \ | |
| && rm -rf /var/lib/apt/lists/* | |
| COPY package*.json ./ | |
| COPY scripts/build/postinstall.mjs ./scripts/build/postinstall.mjs | |
| COPY scripts/build/postinstallSupport.mjs ./scripts/build/postinstallSupport.mjs | |
| COPY scripts/build/native-binary-compat.mjs ./scripts/build/native-binary-compat.mjs | |
| ENV NPM_CONFIG_LEGACY_PEER_DEPS=true | |
| # --ignore-scripts blocks broad dependency install/postinstall hooks, closing | |
| # the supply-chain attack surface where a transitive dep can run arbitrary code | |
| # at install time. better-sqlite3 still needs a native binding for the target | |
| # platform, so rebuild and smoke-test only that known runtime dependency below. | |
| # | |
| # We REQUIRE a committed package-lock.json so resolved dependency versions | |
| # are reproducible. | |
| RUN test -f package-lock.json \ | |
| || (echo "package-lock.json is required for reproducible Docker builds" >&2 && exit 1) | |
| RUN --mount=type=cache,target=/root/.npm \ | |
| npm ci --no-audit --no-fund --legacy-peer-deps --ignore-scripts \ | |
| && npm rebuild better-sqlite3 \ | |
| && node -e "require('better-sqlite3')(':memory:').close()" | |
| # Use Turbopack for significant build speedup | |
| ENV OMNIROUTE_USE_TURBOPACK=1 | |
| COPY . ./ | |
| RUN --mount=type=cache,target=/app/.build/next/cache \ | |
| mkdir -p /app/data && npm run build | |
| # ββ Runner base ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ | |
| FROM base AS runner-base | |
| LABEL org.opencontainers.image.title="omniroute" \ | |
| org.opencontainers.image.description="Unified AI proxy β route any LLM through one endpoint" \ | |
| org.opencontainers.image.url="https://omniroute.online" \ | |
| org.opencontainers.image.source="https://github.com/diegosouzapw/OmniRoute" \ | |
| org.opencontainers.image.licenses="MIT" | |
| ENV NODE_ENV=production | |
| ENV PORT=7860 | |
| ENV HOSTNAME=0.0.0.0 | |
| ENV OMNIROUTE_MEMORY_MB=1024 | |
| ENV NODE_OPTIONS="--max-old-space-size=${OMNIROUTE_MEMORY_MB}" | |
| # Data directory inside Docker β defaults to /data for compatibility with Hugging Face Space persistent storage | |
| ENV DATA_DIR=/data | |
| RUN mkdir -p /data && chown -R node:node /data | |
| # `npm run build` (build-next-isolated β assembleStandalone) bundles ALL runtime | |
| # files into .build/next/standalone/ β .next, node_modules, migrations, scripts, | |
| # docs, and the previously hand-COPY'd modules below (@swc/helpers, pino-*, split2, | |
| # migrations). assembleStandalone copies them straight from the builder's | |
| # node_modules, so they are present regardless of NFT/Turbopack trace behaviour. | |
| # The old per-module overrides were therefore pure duplication and were removed | |
| # (build-output-isolation cleanup). See scripts/build/assembleStandalone.mjs | |
| # (EXTRA_MODULE_ENTRIES) for the single source of truth. | |
| COPY --from=builder /app/.build/next/standalone ./ | |
| # better-sqlite3 is the one exception still copied explicitly: assembleStandalone | |
| # only syncs its native build/ dir; the JS wrapper (lib/, package.json) is left to | |
| # Next.js tracing. bootstrap-env requires SQLite BEFORE the standalone server | |
| # starts, so guarantee the complete package independent of trace behaviour. | |
| COPY --from=builder /app/node_modules/better-sqlite3 ./node_modules/better-sqlite3 | |
| # migrations land at <standalone>/migrations via assembleStandalone; point the runtime at them. | |
| ENV OMNIROUTE_MIGRATIONS_DIR=/app/migrations | |
| # Docker healthcheck script β not traced by Next.js standalone output, so copy | |
| # it explicitly. The HEALTHCHECK CMD references it as `node healthcheck.mjs`. | |
| COPY --from=builder /app/scripts/dev/healthcheck.mjs ./healthcheck.mjs | |
| # Hand /app over to the baked-in `node` non-root user (UID/GID 1000) so the | |
| # runtime process never holds root privileges. The chown happens after all | |
| # COPYs so it covers files originally owned by root in the builder stage. | |
| RUN chown -R node:node /app | |
| EXPOSE 7860 | |
| # Drop to non-root before ENTRYPOINT/CMD so every derived stage (runner-cli, | |
| # runner-web) also runs as a non-root user unless they explicitly switch back. | |
| USER node | |
| # Warns if the mounted data volume has wrong ownership | |
| COPY --chmod=755 scripts/check-permissions.sh /tmp/check-permissions.sh | |
| ENTRYPOINT ["/tmp/check-permissions.sh"] | |
| HEALTHCHECK --interval=30s --timeout=5s --start-period=15s --retries=3 \ | |
| CMD ["node", "healthcheck.mjs"] | |
| CMD ["node", "dev/run-standalone.mjs"] | |
| # ββ Runner Web (web-cookie providers: Gemini Web, Claude Turnstile) βββββββββββ | |
| # | |
| # Two image flavors: | |
| # runner-base β omniroute:VERSION Lean base (~500 MB). No browsers. | |
| # runner-web β omniroute:VERSION-web +Chromium/Playwright (~800 MB). | |
| # | |
| # Use runner-web when you need web-cookie providers (gemini-web, claude-web, | |
| # claude-turnstile). For all other providers runner-base is sufficient. | |
| # | |
| # Build: | |
| # docker build --target runner-web -t omniroute:web . | |
| # Compose: | |
| # build: | |
| # context: . | |
| # target: runner-web | |
| FROM runner-base AS runner-web | |
| USER root | |
| # Install Playwright browser binaries + OS dependencies under root, then hand | |
| # ownership of the browsers cache to the node user. | |
| # PLAYWRIGHT_BROWSERS_PATH overrides the default ~/.cache/ms-playwright so the | |
| # browsers land under /home/node which persists across image layers and is | |
| # accessible to the non-root runtime user. | |
| ENV PLAYWRIGHT_BROWSERS_PATH=/home/node/.cache/ms-playwright | |
| RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \ | |
| --mount=type=cache,target=/var/lib/apt/lists,sharing=locked \ | |
| apt-get update \ | |
| && npx playwright install chromium --with-deps \ | |
| && chown -R node:node /home/node/.cache \ | |
| && rm -rf /var/lib/apt/lists/* | |
| USER node | |
| FROM runner-base AS runner-cli | |
| # Drop back to root briefly so we can install system + global npm packages, | |
| # then return to the `node` non-root user before the CMD inherited from | |
| # runner-base runs. | |
| USER root | |
| # Install system dependencies required by openclaw (git+ssh references). | |
| RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \ | |
| --mount=type=cache,target=/var/lib/apt/lists,sharing=locked \ | |
| apt-get update \ | |
| && apt-get install -y --no-install-recommends git ca-certificates docker.io docker-compose \ | |
| && rm -rf /var/lib/apt/lists/* \ | |
| && git config --system url."https://github.com/".insteadOf "ssh://git@github.com/" | |
| # Install CLI tools globally. Separate layer from apt for better cache reuse. | |
| RUN --mount=type=cache,target=/root/.npm \ | |
| npm install -g --no-audit --no-fund @openai/codex @anthropic-ai/claude-code droid openclaw@latest | |
| USER node | |