Skip to Content

Self-Host Coolify: Deploy Any App in 15 Minutes

Self-Host Coolify: Deploy Any App in 15 Minutes

Tired of complex CI/CD pipelines just to deploy a simple app? Coolify is an open-source, self-hosted Platform-as-a-Service (PaaS) that lets you deploy applications, databases, and services with zero configuration headaches. Think of it as your own private Heroku — but you own the infrastructure, control the costs, and keep your data private.

In this guide, you’ll self-host Coolify on a VPS and deploy your first application in under 15 minutes.

Why Self-Host Coolify?

  • One-click deployments for Docker, Node.js, PHP, Python, Ruby, and more
  • Built-in databases — PostgreSQL, MySQL, Redis, MongoDB with one click
  • Automatic HTTPS via Let’s Encrypt
  • Git integration — auto-deploy on push
  • No vendor lock-in — runs on any VPS, your data stays yours

Prerequisites

  • A VPS with 2 vCPU, 4GB RAM, 20GB SSD (minimum)
  • Docker & Docker Compose installed
  • A domain or subdomain pointed to your VPS
  • Ports 80, 443, and 8000 open

Step 1: Install Coolify

Coolify provides a one-line installer. Run this on your VPS:

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

This script will:

  • Install Docker if not present
  • Pull the Coolify image
  • Start the Coolify server on port 8000

Step 2: Access the Dashboard

Once installation completes, open your browser:

http://your-vps-ip:8000

Complete the initial setup:

  1. Create an admin account
  2. Add your server (localhost if single-node)
  3. Configure your domain (e.g., coolify.yourdomain.com)

Step 3: Deploy Your First Application

Let’s deploy a simple Node.js app as an example.

3.1 Create a New Project

In the Coolify dashboard:

  1. Click ProjectsAdd
  2. Name it hello-world
  3. Click Add New ResourceApplication

3.2 Connect Your Repository

  • Select GitHub, GitLab, or Public Repository
  • Paste your repo URL (e.g., https://github.com/yourname/your-app)
  • Choose the branch (usually main)

3.3 Configure Build Settings

Coolify auto-detects your app type, but you can customize:

Build Pack: Nixpacks (recommended)
Port: 3000
Domain: app.yourdomain.com

3.4 Deploy

Click Deploy. Coolify will:

  • Clone your repo
  • Build the Docker image
  • Start the container
  • Configure Nginx reverse proxy
  • Issue an SSL certificate

Your app will be live at https://app.yourdomain.com within 2–3 minutes.

Step 4: Add a Database (Optional)

Need PostgreSQL or Redis? Click Add New ResourceDatabase → select your database. Coolify handles the container, networking, and environment variables automatically.

Verification Steps

  1. Visit https://app.yourdomain.com — your app loads with SSL
  2. Check Deployments tab in Coolify — status shows "Deployed"
  3. Push a commit to your repo — Coolify auto-redeploys (if webhook is configured)
  4. Run docker ps on your VPS — see Coolify and app containers running

Next Steps

  • Enable auto-deploy by adding a GitHub/GitLab webhook
  • Set up environment variables in Coolify dashboard (secrets are encrypted)
  • Add a CDN like Cloudflare in front for caching
  • Configure backups for your databases
  • Scale horizontally by adding multiple servers to Coolify

Related Guides


Self-hosting doesn’t have to be hard. Coolify proves you can have PaaS convenience with infrastructure independence. Deploy your next project on your own terms.

Self-Host Grafana & Prometheus: Complete Monitoring Stack in 15 Minutes