Coolify

Coolify is a self-hosted PaaS (like Heroku/Vercel) that you run on your own server. It handles Docker builds, TLS, and deployments from a web UI.

Prerequisites

• A server with Coolify installed (install guide)
• Your WCP repo on GitHub, GitLab, or Gitea

1. Create a New Resource

1. Open your Coolify dashboard
2. Go to Projects → select or create a project
3. Click + New Resource → Docker Based → Dockerfile

2. Connect Your Repository

• Select your Git provider (GitHub / GitLab / Gitea)
• Choose the lucasmella-stack/WCP repository
• Branch: main
• Dockerfile path: Dockerfile (at repo root)

3. Configure the Service

General Settings

Setting	Value
Port	8000
Health Check Path	/health
Health Check Interval	30

Environment Variables

Add these in the Environment Variables tab:

Key	Value
WCP_DB_PATH	/data/sync.db
WCP_CONFIG_PATH	/data/config.json
WCP_CORS_ORIGINS	https://dashboard.yourdomain.com

Persistent Storage

In the Storages tab, add a volume:

Source	Destination
wcp-data	/data

Domain

In the Domains tab, add your domain (e.g., wcp.yourdomain.com). Coolify will provision a Let’s Encrypt certificate automatically.

4. Deploy

Click Deploy. Coolify builds the Docker image and starts the container.

Monitor the build logs in the Coolify UI. Once the health check passes, your instance is live.

5. Deploy the Dashboard

Create a second resource:

1. + New Resource → Docker Based → Static Site (or Dockerfile)
2. Same repo, but set:
   • Build command: cd dashboard && npm ci && npm run build
   • Publish directory: dashboard/dist
3. Add env: VITE_API_URL=https://wcp.yourdomain.com
4. Set domain: dashboard.yourdomain.com
5. Deploy

Auto-Deploy

Enable Auto Deploy in the resource settings. Coolify will rebuild and deploy on every push to your configured branch.

Backups

Coolify supports scheduled backups of volumes. Configure them in Settings → Backups to protect your SQLite database.