This guide uses Docker Compose to run Automatisch from the official repository.
For Docker installation, see Docker.
git clone https://github.com/automatisch/automatisch.git
cd automatisch
Automatisch requires three secret keys for security. Generate them before starting:
# Generate ENCRYPTION_KEY (encrypts credentials)
openssl rand -base64 36
# Generate WEBHOOK_SECRET_KEY (verifies webhooks)
openssl rand -base64 36
# Generate APP_SECRET_KEY (user authentication)
openssl rand -base64 36
Save these values for the next step.
Create a .env file in the repository root:
cat <<'ENV' > .env
# Application settings
HOST=localhost
PROTOCOL=http
PORT=3000
APP_ENV=production
TZ=UTC
# Secret keys (replace with your generated values)
ENCRYPTION_KEY=your-encryption-key-here
WEBHOOK_SECRET_KEY=your-webhook-secret-key-here
APP_SECRET_KEY=your-app-secret-key-here
# PostgreSQL settings
POSTGRES_HOST=postgres
POSTGRES_PORT=5432
POSTGRES_DATABASE=automatisch
POSTGRES_USERNAME=automatisch
POSTGRES_PASSWORD=your-database-password-here
# Redis settings
REDIS_HOST=redis
REDIS_PORT=6379
ENV
Important: Replace the placeholder keys with your generated values.
docker compose up -d
Open http://YOUR-SERVER:3000 to access the web UI.
Create your first user account through the sign-up form. There are no default credentials.
Automatisch requires 4 services:
| Service | Purpose |
|---|---|
| main | Web UI and API server (port 3000) |
| worker | Background job processing |
| postgres | PostgreSQL database |
| redis | Job queue and caching |
For production deployments:
PROTOCOL=https and configure a reverse proxyENCRYPTION_KEY or WEBHOOK_SECRET_KEY will break existing connections and flowsTo update Automatisch:
git pull origin main
docker compose pull
docker compose up -d
Deploying Automatisch in containers for production? Our consulting covers:
Get expert help: office@linux-server-admin.com | Contact Page