Custom Dockerfile

Bring your own container image build (runtime_kind: custom_dockerfile) when you need full control over the OS, packages, and entrypoint.

Requirements

  • A valid Dockerfile at the repository root or under the configured root directory
  • An application process that listens on the container listen port you declare in runtime options (the edge proxy targets this port inside the container network)
  • A health check path suitable for HTTP probing once the container is up
Custom images are built without mutating your source tree—plan multi-stage builds and dependency caching inside the Dockerfile itself.

Example skeleton

Dockerfile
FROM node:20-bookworm-slim
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
ENV NODE_ENV=production
EXPOSE 3000
CMD ["node", "server.js"]

See also