Source development and image builds

Start the development environment

Prepare Node.js 24+, pnpm 10.34.6, Docker Engine / Compose, rsync, and mkcert. Run from the repository root:

pnpm install --frozen-lockfile
pnpm dev:prepare
pnpm dev

pnpm dev:prepare starts services, builds images and the help center, and initializes the development database while preserving existing configuration. The first run may ask to trust the local mkcert CA. pnpm dev attaches watchers and logs; pnpm dev:stop stops the development stack.

Default addresses: Web http://localhost:18172 / https://localhost:18173, API http://localhost:4000, Runner http://localhost:4010. Use the actual addresses reported by the launcher.

Source entry points

• Web workspace and administration
• API, permissions, and business logic
• Runner and task Workers

See the architecture, repository development guide, and contribution guide. Run affected tests, type checks, lint, and builds before submitting changes.

Build Docker images from source

docker compose --env-file .env.example build \
  migrate api runner runner-worker-image web

The API Dockerfile provides runtime and migration targets; the Runner provides controller and worker. For multi-architecture images, use docker buildx build --platform linux/amd64,linux/arm64 with the appropriate Dockerfile and target. Prefer digest-pinned published images for normal production installations. The maintainers' Git production runbook covers a separate source-build workflow.