Skip to main content

Docker installation

Local development (Windows)​

From the repository root:

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/groove/local-docker.ps1

This builds server, client, and RTS, creates image groovebuilder/local:local, starts the integration broker on port 8090, and Groove Builder on 8080.

Build only​

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/groove/local-docker.ps1 -BuildOnly

Start an existing image​

cd deploy/docker
$env:GROOVE_BUILDER_IMAGE = "groovebuilder/local:local"
docker compose -f docker-compose.local.yml up -d

Persistent data lives under deploy/docker/stacks/.

docker compose -f deploy/docker/docker-compose.local.yml logs -f
docker compose -f deploy/docker/docker-compose.local.yml down

Prerequisites​

  • Docker Desktop (or Docker Engine)
  • For full local builds: Node.js 24.x, Yarn, JDK 25, Maven 3.9.x

Production notes​

  • Point GROOVE_CLOUD_SERVICES_BASE_URL (or APPSMITH_CLOUD_SERVICES_BASE_URL) at your Groove integration broker — never at Appsmith-operated cloud services.
  • Configure SMTP for invites and password reset (Email).
  • Set admin bootstrap emails via environment variables (Environment variables).
  • Compose image is controlled by GROOVE_BUILDER_IMAGE in deploy/docker/.env.prod (default groovebuilder/local:prod). To deploy from GitHub Container Registry instead of docker save/scp/load, publish with scripts/groove/publish-ghcr.ps1, then set e.g. GROOVE_BUILDER_IMAGE=ghcr.io/automatedcoffee/groove-builder:prod and docker compose ... pull && up -d on the droplet.

See also Integration broker and Helm.