Open the server Apps tab
Select your VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.


Open-source workflow automation - self-hosted Zapier alternative
Add your server credentials to Server Compass
Choose from our template library
Fill in settings and click Deploy
Use the Activepieces template in Server Compass to deploy a self-hosted workflow automation platform with Postgres and Redis on your VPS, then verify the Activepieces web UI in a browser.
Select your VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Use the template picker search to find Activepieces in the Server Compass template catalog.

Choose the Activepieces template. Server Compass fills the Activepieces web service, Postgres database, Redis service, encryption key, JWT secret, database name, database user, and database password.

Confirm the app name and compose services. In this run, the app was named activepieces-demo and used host port 3001.

Review the generated environment values, confirm the port is available, and click Deploy Now.

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Activepieces image, starts the container, and verifies the stack.

After deployment finishes, return to the Apps tab and confirm the Activepieces app is marked Running with its application URL available.

Open the application URL in a browser. The Activepieces web UI confirms the stack is reachable.

It deploys Activepieces with Postgres and Redis services.
The tutorial verified Activepieces on host port 3001, which maps to the Activepieces web service on container port 80.
The tutorial verifies the clean Activepieces first-run web UI because admin setup, flows, credentials, and external integrations depend on the production server.
No. The deployment guide should live on the Activepieces template detail page and be linked from the reusable template deployment docs page.
Get your hands dirty: manual Activepieces deployment guide for developers.
Access your server's command line by opening a terminal and running the SSH command below.
# SSH into your server
ssh root@your-server-ip
# Using a custom SSH key
ssh -i ~/.ssh/id_rsa root@your-server-ipFirst time? Need Docker? Install it: curl -fsSL https://get.docker.com | sh
Set up the folder structure for your Docker deployment.
# Create and navigate to project directory
mkdir -p ~/apps/activepieces
cd ~/apps/activepiecesSet up your Docker Compose file with this configuration:
services:
activepieces:
image: activepieces/activepieces:latest
ports:
- "8080:80"
environment:
- AP_ENGINE_EXECUTABLE_PATH=dist/packages/engine/main.js
- AP_ENCRYPTION_KEY=<your-encryption-key>
- AP_JWT_SECRET=<your-jwt-secret>
- AP_FRONTEND_URL=http://localhost:8080
- AP_POSTGRES_DATABASE=activepieces
- AP_POSTGRES_HOST=db
- AP_POSTGRES_PORT=5432
- AP_POSTGRES_USERNAME=activepieces
- AP_POSTGRES_PASSWORD=<your-db-password>
- AP_REDIS_HOST=redis
- AP_REDIS_PORT=6379
- AP_SANDBOX_RUN_TIME_SECONDS=600
- AP_TELEMETRY_ENABLED=false
restart: unless-stopped
depends_on:
db:
condition: service_healthy
redis:
condition: service_healthy
db:
image: postgres:16-alpine
environment:
- POSTGRES_DB=activepieces
- POSTGRES_USER=activepieces
- POSTGRES_PASSWORD=<your-db-password>
volumes:
- db_data:/var/lib/postgresql/data
restart: unless-stopped
healthcheck:
test: ["CMD-SHELL", "pg_isready -U activepieces -d activepieces"]
interval: 10s
timeout: 5s
retries: 5
start_period: 30s
redis:
image: redis:7-alpine
volumes:
- redis_data:/data
restart: unless-stopped
healthcheck:
test: ["CMD", "redis-cli", "ping"]
interval: 10s
timeout: 5s
retries: 5
volumes:
db_data:
redis_data:
PORTHost port to expose(default: 8080)ENCRYPTION_KEYEncryption key (32 chars)JWT_SECRETJWT secretDB_NAMEDatabase name(default: activepieces)DB_USERDatabase user(default: activepieces)DB_PASSWORDDatabase passwordStart all services defined in your compose file.
# Start the containers in detached mode
docker compose up -d
# Check if containers are running
docker compose ps
# View logs
docker compose logs -fOpen the port so you can access the application externally.
# Allow the application port through firewall
sudo ufw allow 8080/tcp
sudo ufw reload
# Access your app at:
# http://your-server-ip:8080Why type commands when you can click? Deploy Activepieces the easy way with Server Compass.
After deploying Activepieces with Server Compass, complete these steps to finish setup
Create your admin account
Create your first flow
Need help? Check out our documentation for detailed guides.
Common questions about self-hosting Activepieces
Simply download Server Compass, connect to your VPS, and select Activepieces from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.
Activepieces requires a minimum of 512MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.
Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Activepieces backup and restore procedures.
Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Activepieces image will be pulled and deployed with zero downtime.
Activepieces is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Open-source backend in a single file with realtime database, auth, and file storage

Open-source backend-as-a-service - self-hosted Firebase alternative

Open-source backend framework with dashboard

Full Supabase self-hosted with Kong, GoTrue Auth, Realtime, and Studio
Download Server Compass and deploy Activepieces to your VPS in under 3 minutes. No Docker expertise required.
Download Server Compass