Skip to Content

Self-Host Coolify: Your Own Vercel/Netlify Alternative in 20 Minutes

Self-Host Coolify: Your Own Vercel/Netlify Alternative in 20 Minutes

Remember the last time you wanted to deploy a side project and ended up wrestling with Docker Compose files, Nginx configs, and SSL certificates for hours? Or when you paid Vercel $20/month just to host a simple Next.js app with a custom domain?

Coolify changes that.

Coolify is an open-source, self-hostable Platform-as-a-Service (PaaS) that lets you deploy applications, databases, and services with the same one-click simplicity you get from Vercel or Netlify — except it runs on your server, costs nothing, and gives you full control.

In this guide, we'll set up Coolify on a fresh VPS and deploy your first application in under 20 minutes.

Why Self-Host Coolify?

  • No vendor lock-in: Your code, your server, your rules
  • Unlimited projects: No per-seat or per-project pricing
  • One-click deployments: Git push → auto-deploy, just like Vercel
  • Built-in databases: PostgreSQL, MySQL, MongoDB, Redis, and more
  • Automatic SSL: Let's Encrypt integration out of the box
  • Git integration: GitHub, GitLab, Bitbucket, Gitea

Prerequisites

  • A VPS with at least 2 CPU cores, 2GB RAM, and 20GB disk (4GB+ RAM recommended for multiple apps)
  • Ubuntu 22.04 or Debian 12 (other distros work, but these are battle-tested)
  • Docker installed (Coolify will handle this if not)
  • A domain pointed to your server (optional but recommended)

Step 1: Install Coolify

Coolify provides a one-line installer that handles everything:

curl -fsSL https://get.coollabs.io/coolify | bash

This script will:

  1. Install Docker if it's not present
  2. Download the Coolify Docker images
  3. Set up the Coolify core services (PostgreSQL, Redis, Soketi)
  4. Start the Coolify dashboard on port 8000

Once complete, you'll see output like:

Coolify is now installed!
Access it at: http://your-server-ip:8000

Step 2: Initial Setup

Open http://your-server-ip:8000 in your browser. You'll be greeted with a registration screen — create your admin account.

Important: If you're exposing this to the internet, set up a reverse proxy (like Traefik or Nginx) with SSL immediately. Coolify itself doesn't handle SSL for its own dashboard.

Step 3: Add Your Server

Coolify works with:

  • Localhost: The server Coolify is installed on (default)
  • Remote servers: Any server you can SSH into

For this guide, we'll use localhost. Go to Servers → Add Server and select localhost. Coolify will verify the connection and check Docker.

Step 4: Deploy Your First Application

Let's deploy a simple Node.js app from GitHub:

  1. Go to Projects → Add Project and name it my-first-app
  2. Click Add Application
  3. Choose GitHub (or your Git provider)
  4. Authorize Coolify to access your repositories
  5. Select your repository and branch
  6. Coolify auto-detects the framework (Next.js, Nuxt, Astro, etc.)
  7. Click Deploy

Coolify will:

  • Clone your repository
  • Detect the build settings
  • Build the Docker image
  • Start the container
  • Assign a URL (or connect your custom domain)

Step 5: Add a Database

Need PostgreSQL for your app?

  1. In your project, click Add Database
  2. Choose PostgreSQL
  3. Set a name, user, password, and database name
  4. Click Deploy

Coolify gives you the connection string and even links it to your application environment variables automatically.

Step 6: Set Up Auto-Deploy

Enable Watch Paths in your application settings. Coolify will automatically redeploy whenever you push to your repository — just like Vercel.

You can also add a webhook to your Git provider for instant deployments.

Verification

Check that everything is running:

# Check Coolify services
docker ps | grep coolify

# Check your deployed apps
docker ps | grep -v coolify

# View logs
docker logs coolify

Visit your app's URL — you should see your application live.

What's Next?

Now that Coolify is running, you can:

  • Add a custom domain: Point your domain to your server and enable SSL
  • Set up monitoring: Integrate with Uptime Kuma or Grafana
  • Add more services: Deploy Redis, MongoDB, or even one-click apps like Ghost, Plausible, or n8n
  • Configure backups: Use Coolify's built-in backup features or integrate with Borgmatic
  • Scale horizontally: Add more servers to your Coolify cluster

Related Guides

Coolify brings the developer experience of modern cloud platforms to your own infrastructure. No more surprise bills, no more limitations — just deploy.

Self-Host Traefik: The Ultimate Reverse Proxy for Your Homelab in 20 Minutes