Deployment

Build BlendDuck for Node, Docker, or Cloudflare Workers.

Documentation owner:
BlendDuck Documentation
Last reviewed:

Node

pnpm build
pnpm start

The production server is emitted at .output/server/index.mjs. Use Postgres and shared object storage when running more than one application instance.

Docker

docker compose up --build

The container entrypoint applies the active database migrations before starting the server. Review that behavior before adopting a deployment strategy with multiple replicas.

Cloudflare Workers

pnpm cf:build
pnpm db:d1:migrate
pnpm cf:deploy

Cloudflare uses D1 and R2 bindings. Apply reviewed D1 migrations explicitly; the production deploy command does not silently invent or apply schema changes.

Required production boundaries

  • APP_URL must be the canonical public HTTPS origin.
  • Secrets belong in the hosting provider's secret store.
  • Proxies must preserve authorization and MCP protocol headers.
  • Durable jobs require the configured worker backend; do not rely on an ephemeral request continuing after the response completes.