How to Deploy Your First Application with Coolify

Setting up Coolify on your own server is one of the best decisions you can make for your deployment workflow. This step-by-step guide will walk you through installing Coolify, configuring your first server, and deploying a real application — all in under 15 minutes.

Prerequisites

Before you begin, you'll need a Linux server (Ubuntu 22.04+ recommended) with Docker and Docker Compose installed. A basic VPS with 2GB RAM and 2 CPUs is sufficient for getting started. You'll also need a domain name pointing to your server's IP address if you want automatic HTTPS certificates.

Step 1: Install Coolify

SSH into your server and run the following command to pull and start the Coolify Docker container:

docker pull coollabsio/coolify:next
docker run -d \
  --name coolify \
  --restart unless-stopped \
  -p 8080:8080 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v coolify-data:/data \
  coollabsio/coolify:next

Step 2: Complete the Setup Wizard

Navigate to http://your-server-ip:8080 in your browser. The setup wizard will guide you through:

Creating an admin account — set your email and password
Connecting your server — Coolify uses SSH to manage your server; the wizard helps you add your server's public key
Linking Git providers — connect GitHub, GitLab, or Bitbucket repositories for automatic deployments
Setting up a domain — configure your domain for automatic SSL/TLS certificates

Step 3: Deploy Your First Application

From the Coolify dashboard, click "New Resource" and you'll see three options:

Application: Deploy code from a Git repository. Coolify detects the language automatically (Node.js, Python, PHP, Go, etc.), sets up the build process, and deploys it as a Docker container.

Database: One-click deployment of PostgreSQL, MySQL, MongoDB, Redis, and more. Each database gets its own isolated Docker container with persistent storage.

Service: 280+ pre-configured services including WordPress, Plausible Analytics, N8N, MinIO, and many more.

For a quick start, choose "Application", point it to a public GitHub repository, and click "Deploy". Coolify will clone the repo, build the Docker image, and serve it behind a reverse proxy with automatic HTTPS.

Step 4: Configure Automatic Deployments

One of Coolify's most powerful features is automatic deployment on Git push. Once your Git provider is linked, every push to your repository's main branch triggers a new deployment automatically. You can also configure preview deployments for pull requests, perfect for testing changes before merging.

Advanced Features Worth Exploring

Coolify offers several advanced capabilities that make it a true Heroku alternative:

Instant Rollback: Every deployment is versioned. If a new deployment breaks something, click "Rollback" to instantly revert to the previous working version.

Real-time Logs: Watch deployment and runtime logs in real-time directly from the dashboard. Filter by service, search for errors, and export logs for debugging.

Resource Monitoring: Track CPU, memory, disk, and network usage for every service at a glance.

Team Collaboration: Invite team members with role-based permissions (admin, read-only, deploy-only).

Conclusion

Coolify transforms your own server into a powerful PaaS with minimal setup. It eliminates the need for expensive managed platforms while giving you complete control over your infrastructure. For developers who value privacy, cost-effectiveness, and the freedom to deploy anything anywhere, Coolify is the definitive self-hosted deployment solution.