TR/EN
Blog

What Is Coolify? How to Install It on Your Server, Step by Step

Published: · 12 min read

Platforms like Heroku, Vercel or Netlify make shipping an app super easy, but as the project grows the bills grow too. For people who want the same comfort on their own server, one of the most talked-about tools of the last few years is Coolify. In this post we answer what is Coolify, what it's good for, how it compares to the alternatives and how to install Coolify on a server, step by step. After the install we'll also deploy a first app, add a database and go over the security settings.

What Is Coolify?

Coolify is a free, open-source PaaS (Platform as a Service) that you install on your own server. In short, you run a Heroku/Vercel style panel on your own virtual server: you connect your Git repo, Coolify builds the app, runs it as a container, attaches the domain and gets the SSL certificate automatically. After every git push a new version can go live on its own.

Under the hood everything runs on Docker containers; Coolify is a management layer that handles those containers, the reverse proxy, certificates and backups for you. The project has an active community with tens of thousands of stars on GitHub; after a long beta, v4 became stable in spring 2026 and at the time of writing the 4.4.x series is current.

Coolify vs Heroku/Vercel vs Plain Docker

CriteriaCoolify (your own server)Heroku / VercelPlain Docker / Compose
Software costFree, open sourceMonthly fee that grows with usageFree
Server costFixed monthly VPS feeIncluded (but pricey)Fixed monthly VPS fee
Control and dataFully yoursWith the providerFully yours
Ease of setupOne command + web panelEasiestEverything by hand
SSL and domainsAutomatic (Let's Encrypt)AutomaticManual (Nginx + certbot etc.)
DatabasesOne click from the panelPaid add-onHand-written compose file
MaintenanceServer upkeep is on youOn the providerEverything is on you

In short, Coolify combines the cost and control advantages of plain Docker with Heroku's ease of use. In return, things like server updates and checking backups are on you.

Coolify's Key Features

FeatureWhat it gives you
Multiple build optionsBuild with Nixpacks (language auto-detected), Dockerfile, Docker Compose and Railpack
Git integrationAutomatic deploy on push from GitHub, GitLab, Bitbucket and other Git repos
Reverse proxy + SSLTraefik by default (Caddy optional), Let's Encrypt certificates issued and renewed automatically
DatabasesPostgreSQL, MySQL, MariaDB, Redis, MongoDB and more installed from the panel
Preview deploymentsA seperate test environment can be spun up for every pull request
BackupsDatabase backups can be scheduled and sent to S3-compatible storage
One-click servicesHundreds of apps like WordPress, n8n, Uptime Kuma and Plausible installed with one click
Multiple serversDeploy to other servers connected over SSH from a single panel

Coolify System Requirements

ResourceMinimumOur recommendation
CPU2 cores4 cores (builds eat CPU)
RAM2 GB8 GB or more (for apps + database + builds)
Disk10 GB40 GB+ NVMe (Docker images fill up space fast)
Architectureamd64 or arm64
Operating systemUbuntu and Debian (recommended), RHEL family (Rocky, AlmaLinux, CentOS), SUSE, Arch, Alpine, Raspberry Pi OS 64-bit
The minimum values are only for Coolify itself. Since you'll run a few apps and databases on top of it, keeping some extra RAM prevents alot of memory issues, especially during builds.

Installing Coolify: Step by Step

We did the steps below on a fresh Ubuntu 24.04 server as root. If you don't have a server yet, have a look at our what is a cloud server post first.

1. Prepare the Server

Update the system and remove Docker if it was installed via snap; Coolify doesn't work with snap Docker:

apt update && apt upgrade -y

# remove Docker installed via snap if present (Coolify doesn't support it)
snap list docker 2>/dev/null && snap remove docker

# install curl if missing
apt install -y curl

2. Run the Install Script

The official install script installs Docker (if missing), creates the required directories and starts the Coolify containers. One command:

curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash

The install takes a few minutes depending on the server. When it's done you can check that the containers are up:

docker ps --format "table {{.Names}}\t{{.Status}}"   # are the coolify containers running?
docker logs coolify --tail 50                         # check the logs if something is wrong

3. Open the Panel and Create the Admin Account

Go to this address in your browser:

http://SERVER_IP:8000
Important: Right after install the registration screen is open to anyone. The first account created becomes the admin, so don't wait on this step; create your own account as soon as the panel opens.

On first login Coolify shows a short onboarding wizard. If you'll run apps on the same server, just pick the "localhost" server.

4. Domain and SSL

In your DNS panel, point A records for the panel and your apps to the server IP:

# A records for the panel and an app
coolify.example.com   A   SERVER_IP
app.example.com       A   SERVER_IP

# optional: wildcard for automatic subdomains per app
*.example.com         A   SERVER_IP

Then in Coolify, enter https://coolify.example.com in the instance domain field under Settings and save. Traefik gets the Let's Encrypt certificate automatically and within a few minutes the panel opens over HTTPS. If you added a wildcard record, you can fill in the wildcard domain field in the server settings so every app gets an automatic subdomain.

5. Deploy Your First App

  1. Create a new project under Projects, then add a resource with + New.
  2. Use "Public Repository" for a public repo, or the GitHub App / deploy key option for a private one.
  3. As the build pack, Nixpacks works without extra config for most Node.js, Python, PHP and Go projects; if the project has a Dockerfile or docker-compose.yml you can pick that instead.
  4. Enter https://app.example.com in the Domains field and, if needed, the port the app listens on and the environment variables.
  5. Hit Deploy. Build logs stream live; when it finishes the app is live with SSL.

With automatic deploys on, every push to the repo ships a new version by itself. If you want a more advanced process with test and approval steps, check out our CI/CD pipeline consulting service.

6. Add a Database

In the same project click + New → Database and pick PostgreSQL, MySQL, Redis or another database. Coolify generates the username and password and gives you the connection URL; just add it to your app's environment variables. You don't need to expose the database, apps on the same server connect over the internal network. Don't forget to set up daily backups and an S3 target in the backups tab.

Security and Firewall

Only open the ports you really need. SSH (22), HTTP (80) and HTTPS (443) are enough; you can open port 8000 just for the initial setup and close it once the panel runs on its domain with SSL:

ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw allow 8000/tcp     # until the panel domain + SSL is set up
ufw enable

# close 8000 once the panel works over HTTPS
ufw delete allow 8000/tcp

Panel features like the terminal and realtime notifications can use extra ports; check the firewall page in Coolify's official docs when you lock down the firewall. A few more tips:

  • Disable password login for SSH and switch to key-based login.
  • Turn on two-factor authentication for the admin account.
  • Don't make databases "public"; if you have to, allow only specific IPs.
  • Keep Coolify and the OS updated. You can upgrade from the panel, and the install script also upgrades an existing install:
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash   # the same script upgrades an existing install

Common Problems

SymptomLikely causeFix
Panel doesn't open on port 8000Firewall is blocking the portCheck UFW and the provider's firewall rules
SSL certificate failsDNS hasn't propagated yet or 80/443 are closedCheck the A record, open 80 and 443, wait a few minutes and retry
Build gets killed (OOM)Not enough RAM during the buildAdd swap or move to a plan with more RAM
Install fails with a Docker errorDocker installed via snapRemove snap Docker and run the script again
App opens but returns 502/504Wrong port set in CoolifyEnter the port the app actually listens on in "Ports Exposes"
Disk fills up fastOld Docker images pile upEnable automatic cleanup in the panel

If you hit memory problems during builds on a small server, a 4 GB swap file is usually enough:

fallocate -l 4G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab

Which VECDC Plan for Coolify?

For a few small apps and a database, VPS-1 (2 Core, 8 GB RAM, 40 GB NVMe) easily covers Coolify's requirements. If you'll run multiple projects, heavy builds or several databases, VPS-2 (4 Core, 12 GB) or VPS-3 (4 Core, 16 GB) is a more comfortable start. VECDC virtual servers come with dedicated CPU, NVMe disks and a 1 Gbps connection from $6/month, are ready in about 5 minutes with automated setup, and you can choose the location when you order.

Our Developer VDS plans come with Docker preinstalled. The Coolify install script detects and uses the existing Docker; unfortunately theres no guarantee it plays well with every custom setup, so the smoothest path is installing Coolify on a clean server.

Frequently Asked Questions

Is Coolify free?

Yes. Coolify is open source and completely free when you install it on your own server; you only pay the server's monthly fee. If you don't want to host the panel yourself, there's also a paid Coolify Cloud option from the developers.

Do I need Kubernetes for Coolify?

No. Coolify runs on Docker and can be installed on a single virtual server. You can connect multiple servers to the same panel over SSH, but no Kubernetes knowledge or cluster is needed.

How many apps can I run on one server with Coolify?

There's no fixed limit; it depends on the server's CPU, RAM and disk. A server with 8 GB RAM comfortably runs a few small web apps and a database; heavy builds and many databases call for more RAM.

What's the difference between Coolify Cloud and self-hosting?

With Coolify Cloud the Coolify team hosts and updates the control panel, while your apps still run on your own servers. When self-hosting, the panel is on your server too; it's free but updates and backups are your responsibility.

In Short

Coolify is a free, open-source PaaS that brings the ease of Heroku and Vercel to your own server. It installs with one command, connects your Git repo and ships your app with SSL in minutes, and manages databases and backups from the same panel. It's a very sensible option for running multiple projects on a fixed-price VPS while keeping control in your hands. If you get stuck during setup, drop us a message, were happy to help.

Your Virtual Server, Ready in 5 Minutes

NVMe virtual servers with dedicated resources start at $6/month.

See Packages →