Coolify

Coolify is a self-hosted Heroku/Netlify alternative that can deploy Docker Compose applications.

Steps

1. Create a Docker Compose resource

In Coolify, click New Resource → Docker Compose.

Paste the following docker-compose.yml:

services:
  awaitstep:
    image: ghcr.io/awaitstep/awaitstep:latest
    restart: unless-stopped
    expose:
      - '8080'
      - '3000'
    env_file:
      - .env
    volumes:
      - awaitstep-data:/app/data

  caddy:
    image: caddy:2-alpine
    restart: unless-stopped
    ports:
      - '80:80'
    configs:
      - source: caddyfile
        target: /etc/caddy/Caddyfile

configs:
  caddyfile:
    content: |
      :80 {
        handle /api/* {
          reverse_proxy awaitstep:8080
        }
        handle {
          reverse_proxy awaitstep:3000
        }
      }

volumes:
  awaitstep-data:

Caddy routes /api/* to the API server and everything else to the web UI. Coolify's Traefik handles TLS on top of this.

2. Set environment variables

First, generate two secret keys on your local machine:

openssl rand -hex 32   # use as TOKEN_ENCRYPTION_KEY
openssl rand -hex 32   # use as BETTER_AUTH_SECRET

Then go to Environment Variables and add:

TOKEN_ENCRYPTION_KEY=your-first-generated-key
BETTER_AUTH_SECRET=your-second-generated-key
BETTER_AUTH_URL=https://workflows.example.com

# Auth — configure at least one
# GITHUB_CLIENT_ID=
# GITHUB_CLIENT_SECRET=
# GOOGLE_CLIENT_ID=
# GOOGLE_CLIENT_SECRET=
RESEND_API_KEY=

Set BETTER_AUTH_URL to the public domain Coolify assigns to the service.

3. Configure storage

Under Storage, add a persistent volume mapped to /app/data.

4. Deploy

Click Deploy.

Notes

• Coolify handles TLS automatically if you configure a domain. Caddy runs on port 80 internally and Coolify's Traefik terminates TLS in front of it.
• The health check endpoint is GET /api/health. Configure this in Coolify's Health Check settings.
• If you use Coolify's built-in PostgreSQL service, set DATABASE_URL to the internal connection string Coolify provides.