name: pilotvault # Production PilotVault stack, with SeaweedFS — pulls prebuilt images from the # registry instead of building from source. Self-contained: one file, no # overlays. Everything an operator needs to set lives in .env. # # 1. cp .env.prod.seaweedfs.example .env (then edit it) # 2. docker compose -f docker-compose.prod.seaweedfs.yml pull # 3. docker compose -f docker-compose.prod.seaweedfs.yml up -d # # This is docker-compose.prod.yml plus an S3 object store: PocketBase keeps its # record files — the document store's scans of pilot certificates, aircraft # registrations, insurance and authorisations — in a SeaweedFS bucket instead of # on the pb_data volume next to the database. The database and PocketBase's own # backups stay on PB_DATA. Clients cannot tell the difference: a document has # always been downloaded through the API Server (GET /api/documents/{id}/file), # never from a storage URL. # # Before turning this on for a stack that already has uploads: PocketBase does # NOT copy existing files into the bucket. See README.md. # # Traffic flow (browser): Web App BFF --/api--> API Server --> PocketBase. # # On first boot: # • PocketBase upserts the superuser from POCKETBASE_ADMIN_* (create-if-missing). # • PocketBase runs the bundled migrations: creates/reconciles every collection # and seeds the baseline org + the superadmin@pilotvault.local app login. # Both steps are idempotent, so restarts and upgrades are safe. services: seaweedfs: image: "${SEAWEED_IMAGE:-chrislusf/seaweedfs:4.45}" container_name: pilotvault-seaweedfs restart: unless-stopped # One process, four roles: master, volume, filer and the S3 gateway. -dir is # the only state it keeps. command: server -dir=/data -s3 -master.volumeSizeLimitMB=1024 environment: # SeaweedFS falls back to these when started without an -s3.config file, # and configuring one identity is what takes the S3 gateway out of its # default allow-anyone mode. The same credentials PocketBase authenticates # with below — one pair to set, in .env. AWS_ACCESS_KEY_ID: "${PB_S3_ACCESS_KEY:?set PB_S3_ACCESS_KEY in .env}" AWS_SECRET_ACCESS_KEY: "${PB_S3_SECRET:?set PB_S3_SECRET in .env}" volumes: # Named volume by default; set SEAWEED_DATA to a host path in .env for a # bind mount, exactly as PB_DATA works. Back it up alongside PB_DATA — # from here on the documents live here, not in the database volume. - "${SEAWEED_DATA:-seaweed_data}:/data" # No published port: the stack reaches the gateway over the compose network. healthcheck: test: ["CMD-SHELL", "wget -qO- http://127.0.0.1:9333/cluster/status || exit 1"] interval: 10s timeout: 3s retries: 12 start_period: 20s seaweedfs-init: image: "${SEAWEED_IMAGE:-chrislusf/seaweedfs:4.45}" container_name: pilotvault-seaweedfs-init # Runs once and exits. PocketBase never issues a CreateBucket of its own and # SeaweedFS will not conjure one on first upload, so something has to. # Creating a bucket that already exists is a no-op, so every later boot # passes straight through. restart: "no" depends_on: seaweedfs: condition: service_healthy entrypoint: ["/bin/sh", "-c"] # `|| true` so a restart is never blocked by the shell's exit status: this # step is best-effort, and a gateway that is genuinely unreachable is # reported by the API Server's own S3 check at boot, with the reason. command: - 'echo "s3.bucket.create -name ${PB_S3_BUCKET:-pilotvault}" | weed shell -master=seaweedfs:9333 || true' pocketbase: image: "${PB_IMAGE:-10.2.1.10:5500/admin/pilotvault-pocketbase:latest}" container_name: pilotvault-pocketbase restart: unless-stopped depends_on: # PocketBase is the process that reads and writes the objects, so the # gateway has to be serving before it is asked to store anything. seaweedfs: condition: service_healthy environment: # The superuser is created/updated on boot (the API Server authenticates # with it). This is the only place the first superuser can be created — the # REST API cannot bootstrap it. On the same boot PocketBase runs the bundled # migrations: every collection, plus the baseline org and the # superadmin@pilotvault.local app login. POCKETBASE_ADMIN_EMAIL: "${POCKETBASE_ADMIN_EMAIL:?set POCKETBASE_ADMIN_EMAIL in .env}" POCKETBASE_ADMIN_PASSWORD: "${POCKETBASE_ADMIN_PASSWORD:?set POCKETBASE_ADMIN_PASSWORD in .env}" volumes: # Named volume by default; set PB_DATA to a host path in .env for a bind mount. - "${PB_DATA:-pb_data}:/pb/pb_data" ports: # Bound to localhost by default — the admin UI (/_/) is reachable only on # the host. Set PB_BIND=0.0.0.0 in .env to expose it on the network. - "${PB_BIND:-127.0.0.1}:${PB_PORT:-8070}:8070" healthcheck: test: ["CMD-SHELL", "wget -qO- http://127.0.0.1:8070/api/health || exit 1"] interval: 10s timeout: 3s retries: 12 start_period: 10s api-server: image: "${API_IMAGE:-10.2.1.10:5500/admin/pilotvault-api-server:latest}" container_name: pilotvault-api-server restart: unless-stopped depends_on: pocketbase: condition: service_healthy # The bucket must exist before the API Server points PocketBase at it. seaweedfs-init: condition: service_completed_successfully environment: API_ADDR: ":8080" # Reach PocketBase by its service name on the internal network. Override # POCKETBASE_URL in .env to point the API Server at a database outside # this stack — that is also how you make a retarget done from the panel # permanent, since the panel's change lasts only for the container's life. POCKETBASE_URL: "${POCKETBASE_URL:-http://pocketbase:8070}" POCKETBASE_ADMIN_EMAIL: "${POCKETBASE_ADMIN_EMAIL}" POCKETBASE_ADMIN_PASSWORD: "${POCKETBASE_ADMIN_PASSWORD}" # Probed by the panel status page. This is a server-to-server call inside # the compose network, so the default is the service name — plain # localhost:8090 would resolve to this container itself. WEBAPP_URL: "${WEBAPP_URL:-http://web-app:8090}" # Same-origin requests go through the Web App BFF, so CORS is only needed # if a browser ever calls the API Server directly. Default to the web origin. CORS_ALLOW_ORIGINS: "${CORS_ALLOW_ORIGINS:-http://localhost:8090}" # Plugin enable-state + config, on the api_data volume below. PLUGINS_FILE: "/app/data/plugins.json" # --- File storage -------------------------------------------------- # The PilotVault API Server reads these on every boot and writes them into # PocketBase's Files storage settings, idempotently. Only record files # move — the document store's blobs. The database and PocketBase's own # backups stay on pb_data. PB_S3_ENABLED: "true" PB_S3_BUCKET: "${PB_S3_BUCKET:-pilotvault}" # The service name: a server-to-server call inside the compose network. PB_S3_ENDPOINT: "http://seaweedfs:8333" # SeaweedFS ignores the region; PocketBase insists on having one. PB_S3_REGION: "${PB_S3_REGION:-us-east-1}" PB_S3_ACCESS_KEY: "${PB_S3_ACCESS_KEY}" PB_S3_SECRET: "${PB_S3_SECRET}" # Path style, because a self-hosted gateway has no per-bucket DNS. PB_S3_FORCE_PATH_STYLE: "true" volumes: # The one thing the API Server keeps on disk: plugins.json. Named volume # by default; set API_DATA to a host path in .env for a bind mount (it # must be writable by uid 10001, the image's runtime user). - "${API_DATA:-api_data}:/app/data" ports: # Localhost-only by default (the Web App reaches it over the internal # network). Set API_BIND=0.0.0.0 to expose the API panel — and the # Fly App uplink, if drones connect here directly — on the network. - "${API_BIND:-127.0.0.1}:${API_PORT:-8080}:8080" healthcheck: # Declared here rather than relying only on the image's HEALTHCHECK, so the # depends_on gate below still works against an older pulled image. test: ["CMD-SHELL", "wget -qO- http://127.0.0.1:8080/healthz || exit 1"] interval: 10s timeout: 3s retries: 12 start_period: 20s web-app: image: "${WEB_IMAGE:-10.2.1.10:5500/admin/pilotvault-web-app:latest}" container_name: pilotvault-web-app restart: unless-stopped depends_on: # Wait for the API Server to be serving rather than merely started. api-server: condition: service_healthy environment: ADDR: ":8090" # The BFF reverse-proxies /api/* to the API Server over the internal network. API_BASE: "http://api-server:8080" ports: # The public front door. Bound on all interfaces so browsers can reach it. - "${WEB_PORT:-8090}:8090" healthcheck: # The BFF has no health route of its own; the SPA index answers 200. test: ["CMD-SHELL", "wget -qO- http://127.0.0.1:8090/ >/dev/null || exit 1"] interval: 10s timeout: 3s retries: 12 start_period: 10s volumes: pb_data: api_data: seaweed_data: