# syntax=docker/dockerfile:1 # --- Build stage ------------------------------------------------------------- # Compile a static Go binary. The Vue panel is pre-built into internal/api/dist # and embedded via //go:embed, so no Node toolchain is needed here. FROM golang:1.26-alpine3.24 AS build WORKDIR /src # Cache module downloads separately from the source for faster rebuilds. COPY go.mod ./ # go.sum is optional (stdlib-only module today); copy it if present. COPY go.su[m] ./ RUN go mod download COPY . . # CGO_ENABLED=0 produces a static binary that runs on a bare alpine image. The # entry point is the cmd/server package. RUN CGO_ENABLED=0 GOOS=linux go build -trimpath -ldflags="-s -w" -o /out/api-server ./cmd/server # --- Runtime stage ----------------------------------------------------------- FROM alpine:3.24 # HTTPS calls to PocketBase need CA certificates; tzdata for correct timestamps. RUN apk add --no-cache ca-certificates tzdata # Run as an unprivileged user. RUN addgroup -S app && adduser -S -G app app COPY --from=build /out/api-server /usr/local/bin/api-server # The server keeps no state on disk: plugin settings, like everything else, live # in PocketBase. The working directory is only where a .env would be read from # at startup if one were mounted, which is a local-development convenience — in # Docker every setting arrives as an environment variable. So no volume, and # nothing to make writable beyond the image layer itself. RUN mkdir -p /app && chown app:app /app WORKDIR /app # Config comes entirely from environment variables (see .env.example). # POCKETBASE_ADMIN_EMAIL / _PASSWORD are optional at startup: without them the # server still runs and a superadmin can configure the connection from the panel. ENV API_ADDR=:8080 EXPOSE 8080 # Liveness only: /healthz answers 200 as soon as the process is serving, and # does not depend on PocketBase, so a database outage does not mark the # container unhealthy. Lets compose gate dependants on condition: service_healthy. HEALTHCHECK --interval=30s --timeout=5s --start-period=20s --retries=3 \ CMD wget -qO- http://127.0.0.1:8080/healthz >/dev/null 2>&1 || exit 1 USER app ENTRYPOINT ["/usr/local/bin/api-server"]