Skip to main content
Coolify is your own Heroku or Vercel on the server: apps from Git, databases, and Docker services come up through a web interface, and the reverse proxy and SSL set themselves up.

Requirements

  • OS – Ubuntu 22.04.
  • RAM – 2 GB for Coolify itself plus room for apps, 4 GB and up is comfortable: VPS-2 or higher. On 1 GB Coolify is unstable and crashes during builds.
  • Docker – no need to install it beforehand, the installer sets up its own. Docker from snap is not supported: remove it before installing.
  • Ports 80, 443, 8000 – must be free. If nginx, Apache, or another panel holds them, the Coolify proxy will not start: stop them, remove them, or move them to another port.

Installation

The installer and requirements get updated, check coolify.io/docs.
  1. SSH – connect to the server (Connection):
  2. Installer – installs Docker Engine, the dependencies, and Coolify into /data/coolify:
    It takes a few minutes, at the end the script prints the dashboard address.
  3. Admin – open http://SERVER_IP:8000 and create the first account: it becomes the owner.
Register right after installing: whoever opens the registration page first gets full control over the server.

Ports

  • 8000 – the Coolify dashboard.
  • 80, 443 – HTTP and HTTPS for apps, SSL issuance.
  • 6001, 6002 – realtime updates and the web terminal.
Docker can bypass ufw through its own iptables rules: a port may stay open even if ufw closed it. For reliable filtering set up ufw-docker. About ufw: Firewall.

Domain and SSL

By default the dashboard runs on the IP over HTTP. To move it to a domain with HTTPS:
  1. A record – point a domain at the server IP, for example coolify.yourdomain.ru: DNS records.
  2. Domain in Coolify – Settings → Configuration → the Instance’s Domain (FQDN) field → https://coolify.yourdomain.ru → Save. Write the address with https://.
  3. SSL – Coolify sets up the reverse proxy (Traefik), gets a Let’s Encrypt certificate, and renews it.
Apps work the same way: set the resource domain with https://, and the certificate is issued automatically.

First deploy

Coolify connects this server (localhost) by itself during installation, no need to add it.
  1. Project – + New → Project, with an environment inside, Production by default.
  2. Resource – + New Resource → a source: a Git repository (public or private), a Docker image, or Docker Compose. Coolify builds and runs it.
  3. Deploy – the app domain with https:// → Deploy. After that every push deploys with a button or automatically via webhook.
Network or port not working – write to @lumisup_robot, software setup is on you. Next: Docker, How to connect a domain to a website.