docker-compose-cookbooks/activepieces_dev

Activepieces

Overview

Activepieces is an open-source automation platform. This stack runs Activepieces with PostgreSQL and Redis.

Project Details

• Project Repository: https://github.com/activepieces/activepieces
• Container Image: GitHub Packages
• Documentation: https://www.activepieces.com/docs
• Reverse Proxy Port: 80

Getting Started

1. Generate secrets and set them in your environment:

   export AP_ENCRYPTION_KEY=$(openssl rand -hex 16)
   export AP_JWT_SECRET=$(openssl rand -hex 32)
   

2. Start the stack: docker compose up -d
3. Open http://localhost:8080 in your browser

Environment Variable Notes

VOL_PATH – base path for persistent data volumes
VOL_PROJECTS – base path for project directories
ACTIVEPIECES_IMAGE – Activepieces container image (default: ghcr.io/activepieces/activepieces:0.44.0)
ACTIVEPIECES_RESTART – restart policy (default: unless-stopped)
ACTIVEPIECES_PORT – host port mapped to container port 80 (default: 8080)
ACTIVEPIECES_DOMAIN – domain for frontend URL
AP_ENCRYPTION_KEY – 256-bit encryption key (32 hex chars, default: changeme – generate with `openssl rand -hex 16`)
AP_JWT_SECRET – JWT signing secret (default: changeme – generate with `openssl rand -hex 32`)
AP_POSTGRES_PASSWORD – PostgreSQL password

Volume Notes

${VOL_PATH}/activepieces_dev/cache – Activepieces cache files
${VOL_PATH}/activepieces_dev/postgres – PostgreSQL data directory
${VOL_PATH}/activepieces_dev/redis – Redis data directory

Network Notes

Requires the external proxy network (Nginx Proxy Manager). An internal bridge network internal is created for inter-service communication.

Docker Run

docker run -d \
  --name activepieces \
  -v ${VOL_PATH:-/data}/activepieces_dev/cache:/usr/src/app/cache \
  -e AP_ENCRYPTION_KEY=your-32-hex-char-key \
  -e AP_JWT_SECRET=your-secret \
  -e AP_POSTGRES_PASSWORD=changeme \
  -e AP_POSTGRES_HOST=postgres \
  -e AP_REDIS_HOST=redis \
  -p 8080:80 \
  --network proxy \
  ghcr.io/activepieces/activepieces:0.44.0

Additional Notes / Gotchas

• AP_ENCRYPTION_KEY and AP_JWT_SECRET are required and must be set before the first run. Changing them after data has been written will cause errors.
• Activepieces requires the UNSANDBOXED execution mode in Docker; switch to SANDBOXED if you need isolation (requires privileged: true).

Dockhand Stack, Deploy from Git

Cookbooks Repository stackname: ACTIVEPIECES_DEV Compose file path: activepieces_dev/compose.yaml Additional env file (optional): activepieces_dev/sample.env

Then "Load" activepieces_dev/sample.env into the Environmental variables in dockhand

Create the Stack