What is Coolify? Complete Installation & Usage Guide 2026

If you have been burned by Heroku's price increases after they killed the free tier, or if you want Vercel-style deployments on your own infrastructure without sharing resources with strangers — Coolify is the answer that over 20,000 developers worldwide have chosen.

Coolify is an open-source PaaS (Platform as a Service) that installs on your own VPS with a single command. It gives you the smooth deployment experience of Heroku or Vercel, but you own the infrastructure completely. Your data stays on your server, and there are zero monthly fees if you self-host.

What is Coolify?

Coolify is an open-source, self-hostable alternative to Vercel, Heroku, Netlify, and Railway. It was created by Andras Bacsai, a Hungarian developer, and has grown into a project with over 20,000 community members on Discord and 3,600+ Coolify Cloud customers as of September 2026.

The core philosophy of Coolify is: "If Docker can package it, Coolify can deploy it." This means you can deploy virtually anything — Node.js web apps, Laravel PHP APIs, Django Python services, Go binaries, static sites, full databases, and over 280+ popular open-source services via one-click templates.

Coolify connects to your servers over SSH, which means it works with any VPS from any provider — DigitalOcean, Hetzner, AWS, GCP, or any other cloud — without vendor lock-in. All settings and configuration are stored on your servers, not on Coolify's infrastructure.

Why Choose Coolify Over Heroku or Vercel?

Here is a direct comparison of Coolify against the major managed PaaS platforms:

Data as of September 2026 — verify current pricing at each provider's website

The cost difference is dramatic. Running 5 apps with databases on Heroku can cost $50-100/month, while the same workload on Coolify + a 4 GB RAM VPS might cost only $15-25/month total.

System Requirements

Before installing Coolify, verify your server meets these requirements (source: coolify.io/docs, September 2026):

Supported Linux distributions:

• Debian-based: Ubuntu (LTS recommended), Debian 11/12
• Red Hat-based: CentOS, Fedora, AlmaLinux, Rocky Linux, RHEL, TencentOS
• SUSE-based: SLES, SUSE, openSUSE
• Arch Linux
• Alpine Linux
• Raspberry Pi OS (64-bit only)

Required open ports: 22 (SSH), 80 (HTTP), 443 (HTTPS), and 8000 (Coolify Dashboard — configurable)

How to Install Coolify

Installing Coolify requires just one command. Run it on your Linux server as root or with sudo:

The installation script will automatically:

1. Detect your Linux distribution and version
2. Check for required dependencies (curl, wget, git)
3. Install Docker Engine if not already present
4. Download and start all Coolify containers
5. Configure a reverse proxy (Traefik/Caddy) for automatic SSL
6. Print the dashboard URL and initial credentials to your terminal

After completion, your Coolify Dashboard will be accessible at http://YOUR_SERVER_IP:8000. You will be prompted to create an admin account on first access. You can then configure a custom domain and SSL immediately.

Updating Coolify later: Navigate to Settings → Update in the dashboard, or enable automatic updates to stay current automatically.

Deploying Your First Application

Once Coolify is running, here is how to deploy your first application:

Step 1: Add a Server

Go to Servers → Add New Server. Enter the IP address, SSH port (22 by default), and the SSH private key that has access to your server. Coolify will test the connection and verify Docker is running correctly.

Step 2: Create a Project and Environment

Create a new Project (e.g., "My API") and choose an environment — Production, Staging, or Development. Environments let you keep workloads isolated and organized.

Step 3: Connect Your Git Repository

Select New Resource → Application, then choose your git provider (GitHub, GitLab, Bitbucket, or self-hosted Gitea) and the repository to deploy. Coolify auto-detects your framework and suggests appropriate build and start commands.

Automatically detected frameworks include: Next.js, Nuxt, SvelteKit, Astro, Laravel, Symfony, Django, FastAPI, Flask, Ruby on Rails, Go, Rust, Java Spring Boot, .NET, static HTML, and more.

Step 4: Configure Domain and SSL

Enter your domain (e.g., app.yourdomain.com), point your DNS A record to the server IP, and Coolify will automatically issue and renew a Let's Encrypt SSL certificate. No cron jobs or certbot commands required.

Step 5: Deploy

Click Deploy. Coolify clones your code, runs the build commands inside a Docker container, and serves your application. You can watch real-time build logs directly in the browser. Once the deployment succeeds, your app goes live immediately.

Enabling Auto-Deploy on Git Push

Coolify supports webhooks from all major git providers. When you configure auto-deploy, every git push to the configured branch triggers a new deployment automatically — no manual clicking required.

Key Features

Git Integration and CI/CD

Connect GitHub, GitLab, Bitbucket, or a self-hosted Gitea instance. Auto-deploy on push to any branch. Coolify also supports Pull Request Preview Deployments — every PR automatically gets a unique URL for review before merging, working exactly like Vercel's preview deployments but on your own server.

Database Management

One-click database deployments with no Docker Compose required. Supported databases include:

• PostgreSQL (multiple versions)
• MySQL / MariaDB
• Redis / Valkey / KeyDB
• MongoDB
• ClickHouse (for analytics workloads)

All databases support automatic backups to S3-compatible storage — Cloudflare R2, Backblaze B2, MinIO, AWS S3, or any compatible endpoint. Configure backup schedules and retention policies from the dashboard.

280+ One-Click Service Templates

Deploy popular open-source software in minutes, not hours. A sample of available templates:

• CMS: WordPress, Ghost, Strapi, Directus, Payload CMS
• Analytics: Plausible, Umami, Grafana, Prometheus
• Storage: Nextcloud, MinIO, Seafile
• Monitoring: Uptime Kuma, Netdata, Grafana stack
• Dev Tools: Gitea, n8n, Drone CI, Appsmith
• Search: Meilisearch, Elasticsearch, Typesense
• Media: Jellyfin, Immich, Photoprism
• Backend: Appwrite, Supabase, PocketBase
• AI: Ollama, Open WebUI, LocalAI

Automatic SSL with Let's Encrypt

Coolify uses Traefik or Caddy as its reverse proxy, both of which handle Let's Encrypt certificate issuance and renewal automatically. Wildcard certificates are also supported. You never have to run certbot or set up renewal cron jobs manually.

Real-time Monitoring and Alerts

Monitor CPU, RAM, disk, and network usage for each container in real time through the dashboard. Set up deployment failure and service downtime alerts via:

• Discord webhooks
• Telegram bots
• Email (SMTP)
• Slack webhooks
• Custom webhooks for other integrations

Team Collaboration

Create teams, invite members, and assign granular permissions. Unlimited team members are supported on both self-hosted and Coolify Cloud plans. Multiple teams can share one Coolify instance with isolated projects.

API, CLI, and MCP

Automate deployments programmatically with the Coolify REST API, use the CLI for terminal-based workflows, or leverage MCP (Model Context Protocol) for AI tool integrations. All approaches support the full deployment lifecycle.

Browser-based Terminal

Access a container's terminal directly through the Coolify web UI without SSHing into your server. Useful for quick debugging, database migrations, or running one-off commands in production.

Coolify Cloud vs Self-Hosted

Coolify offers two deployment modes. Here is how they compare:

Recommendation: For most developers, self-hosted is the clear winner. You get identical features with no Coolify fee on top of your VPS cost. The only reason to choose Coolify Cloud is if you want someone else to handle Coolify's own maintenance and updates.

Pricing (September 2026)

Data as of September 2026 — verify current pricing at coolify.io/pricing

Important note: both plans support unlimited servers, unlimited team members, and unlimited deployments. In the cloud plan, Coolify manages the Coolify control plane for you, but your applications and databases always run on your own servers.

Best VPS for Running Coolify

The Coolify team specifically recommends Hetzner (they have a referral partnership), but any VPS with SSH access works. Here are recommended specs by workload size:

A community benchmark: a 4 GB RAM, 2-core server comfortably ran 16 static sites, 9 Rust API services, 5 full-stack apps, 4 Discord bots, and 2 databases simultaneously with average CPU usage of 70-90%.

For users in Southeast Asia who need low latency, providers with Singapore or Thailand datacenters are ideal:

• AsiaGB — Thailand datacenter, Thai language support 24/7, DirectAdmin control panel
• Bangmod Cloud — Thailand VPS, good value for developers
• DigitalOcean — Singapore datacenter, excellent developer UX, $200 credit for new users

Frequently Asked Questions