Tous les guides
Auto-hébergement

How to install Coolify on a VPS (step by step)

Turn a fresh Ubuntu server into your own Heroku/Vercel alternative in about 15 minutes: pick a VPS, open the right ports, install Coolify and secure the dashboard.

Par AI Workspace Team

3 min de lecture

Coolify is an open-source, self-hostable platform for deploying apps, databases and services — think Heroku or Vercel, running on a server you own. One VPS can host all your side projects for a flat monthly price.

What you need

  • A VPS with at least 2 CPU cores, 2 GB RAM and 30 GB of disk. Coolify's own minimum is 2 cores / 2 GB / 10 GB, but Docker images and build caches fill a disk fast. If you build apps on the same server, 4 GB of RAM makes builds much smoother.
  • A fresh Ubuntu 24.04 LTS (or 22.04) install. A clean server avoids conflicts with anything already listening on ports 80 and 443.
  • SSH access as root or a user with sudo.
  • Optional but recommended: a domain name you can add DNS records to.

Picking a VPS

Any provider works. If you don't have one yet, Hostinger's KVM VPS plans are an affordable starting point — use code masterspresses for an extra 5% off. If you'd rather not manage a server at all, Cloudways runs managed cloud servers on DigitalOcean, AWS or Google Cloud.

Partner links: we may earn a commission at no extra cost to you.

Step 1 — Connect and update the server

ssh root@YOUR_SERVER_IP
apt update && apt upgrade -y

Reboot if the upgrade installed a new kernel:

reboot

Step 2 — Open the right ports

Coolify needs these inbound ports:

PortUsed for
22SSH
80HTTP and certificate issuing (Let's Encrypt)
443HTTPS for your apps
8000Coolify dashboard on http://IP:8000
6001Real-time dashboard updates (direct IP access)
6002Coolify web terminal (direct IP access)

Set these in your provider's firewall (Hostinger, DigitalOcean, Hetzner and most others have one in their control panel). Note that ports published by Docker bypass ufw on the server itself, so the provider firewall is the reliable place to restrict access.

You'll close 8000, 6001 and 6002 again in step 6, once the dashboard runs on a domain.

Step 3 — Install Coolify

Run the official installer as root:

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

It installs Docker if needed, sets up Coolify's containers and prints the dashboard URL when it's done. It usually takes a few minutes.

Step 4 — Create your admin account immediately

Open http://YOUR_SERVER_IP:8000 and register. Do this right away: the first person to reach the registration page becomes the instance admin, with root-level control of your server.

Use a long, unique password and turn on two-factor authentication in your profile.

Step 5 — Back up the secrets file

The installer generates the secrets Coolify needs to restore itself into /data/coolify/source/.env. Copy it somewhere safe — your password manager is a good place:

cat /data/coolify/source/.env

Without it, a backup of the server can't be restored cleanly.

Step 6 — Put the dashboard on a domain with HTTPS

  1. At your DNS provider, add an A record: coolify.example.com → YOUR_SERVER_IP.
  2. In Coolify, open Settings and set the instance Domain to https://coolify.example.com.
  3. Wait a minute for the certificate, then open the new URL.
  4. Remove ports 8000, 6001 and 6002 from your firewall. The dashboard, real-time updates and terminal now go through 80/443.

Step 7 — Keep it healthy

  • Turn on automatic updates for Coolify in Settings, or update regularly from the dashboard.
  • Set up database backups to S3-compatible storage (Cloudflare R2, Backblaze B2, AWS S3) for every database you create.
  • Watch disk usage: run cleanup from the server page, or schedule it, so old images don't fill the disk.

Next step

Your server is ready. Now deploy your first app with a custom domain and HTTPS.

Tip: AI Workspace has a Coolify tab in the sidebar, so you can watch deployments and logs right next to your code once your instance is connected.

Créez votre prochaine app avec tous vos agents à la fois

Planifiez, développez, relisez et déployez — le tout depuis un seul espace de travail.

Obtenir Deviloop