Coolify
Coolify is an open-source, self-hosted PaaS and a drop-in alternative to Heroku, Netlify, and Vercel. It deploys applications, databases, and services to your own server with Git-based workflows and a web dashboard, while keeping all your data under your control.
Software included
Section titled “Software included”| Component | Version |
|---|---|
| Coolify | 4.1.2 |
| Docker | Latest stable |
| Docker Compose | Latest stable |
| Ubuntu | 24.04 LTS |
Requirements
Section titled “Requirements”| Resource | Minimum | Recommended |
|---|---|---|
| vCPU | 2 | 4 |
| RAM | 2 GB | 4 GB |
| Storage | 30 GB | 60 GB |
Coolify also runs the applications you deploy, so size the instance for those workloads too.
Getting started
Section titled “Getting started”1. Connect to your VM
Section titled “1. Connect to your VM”ssh ubuntu@<your-vm-ip>2. Wait for first-boot configuration
Section titled “2. Wait for first-boot configuration”On the first boot, a setup script generates the application secrets and starts the full Coolify stack with Docker Compose. This takes 1-2 minutes. Track progress:
journalctl -u coolify-first-boot.service -fThe login message (MOTD) confirms when Coolify is ready.
3. Create the administrator account
Section titled “3. Create the administrator account”Open the dashboard in your browser:
http://<your-vm-ip>:8000The first account you create becomes the root administrator. Set a strong email and password immediately, since registration closes after the first user.
4. Configure your instance
Section titled “4. Configure your instance”- Under Settings, set your instance’s domain so Coolify can issue Let’s Encrypt TLS certificates and serve the dashboard over HTTPS. Coolify includes a built-in reverse proxy that handles routing and certificates for both the dashboard and your deployed apps. DNS must point at the VM before certificates can be issued.
- Connect a Git source (GitHub, GitLab, or a generic repository) to start deploying applications.
Managing Coolify
Section titled “Managing Coolify”Coolify runs as a Docker Compose stack in /data/coolify/source.
# Check statuscd /data/coolify/source && docker compose ps
# Restartcd /data/coolify/source && docker compose restart
# View logscd /data/coolify/source && docker compose logs -fA summary of URLs and paths is written to /data/coolify/info.txt.
Security
Section titled “Security”Ports 8000 (dashboard), 6001 (realtime), 6002 (terminal), 80, and 443 are open on the VM’s network interface. UFW is enabled and allows those ports plus SSH (port 22). Ports 80 and 443 serve your deployed apps and TLS.
Once you configure a custom domain with Let’s Encrypt, reach the dashboard over HTTPS on port 443. You can then close ports 8000, 6001, and 6002 if you no longer need direct access:
sudo ufw delete allow 8000/tcpsudo ufw delete allow 6001/tcpsudo ufw delete allow 6002/tcpComplete the administrator setup promptly after first boot so no one else can claim the root account.