Coolify Self-Hosted PaaS Deployment

Coolify Self-Hosted PaaS Deployment

Quick Start

Install Coolify on VM

ssh -i <key-file> <user>@<instance-ip>
curl -fsSL https://cdn.coollabs.io/​coolify/​install.sh | sudo bash
# Access: http://<instance-ip>:8000

Deploy Application

1. Access Coolify UI at http://<instance-ip>:8000
2. Create admin account (first visitor gets admin)
3. Add GitHub source → Create project → Deploy from repo
4. Access app at http://<container-id>.<instance-ip>.sslip.io

Server Requirements

Required Ports:

• TCP 22 (SSH)
• TCP 80 (HTTP/​Let's Encrypt)
• TCP 443 (HTTPS)
• TCP 8000 (Coolify UI)

Cloud VM Deployment

1. Provision Infrastructure

# Create security group with required ports
# - TCP 22 (SSH)
# - TCP 80 (HTTP)
# - TCP 443 (HTTPS)
# - TCP 8000 (Coolify UI)

# Launch instance with:
# - 2+ vCPU, 2GB+ RAM
# - 30GB+ root volume
# - Ubuntu LTS
# - Public IP
# - SSH key pair

2. Install Coolify

# Set key permissions
chmod 400 /​path/​to/​key.pem

# Connect and install
ssh -o StrictHostKeyChecking=no -i /​path/​to/​key.pem <user>@<instance-ip>
curl -fsSL https://cdn.coollabs.io/​coolify/​install.sh | sudo bash

3. Initial Setup

1. Open browser: http://<instance-ip>:8000
2. IMPORTANT: Create admin account immediately
3. Complete setup wizard

4. Verify Installation

ssh -i /​path/​to/​key.pem <user>@<instance-ip> \
  "sudo docker ps --format 'table {{.Names}}\t{{.Status}}' | grep coolify"

Application Deployment

Supported Build Methods

Deploy from GitHub

1. Add Source: Sources → Add New → GitHub App
2. Create Project: Projects → Add New Project
3. Add Resource: Add New Resource → Public/​Private Repository
4. Configure:
   • Repository URL
   • Branch
   • Build pack (Dockerfile/​Nixpacks)
   • Port to expose
5. Deploy: Click Deploy button

Sample Dockerfile Application

app/
├── main.py          # Application code
├── requirements.txt # Dependencies
└── Dockerfile       # Container definition

Dockerfile:

FROM python:3.12-slim
WORKDIR /​app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
EXPOSE 8080
CMD ["python", "-m", "uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8080"]

Domain Configuration

Auto-generated (sslip.io):

• Format: <container-id>.<public-ip>.sslip.io
• Works immediately, no DNS required

Custom Domain:

1. Add DNS A record → EC2 public IP
2. Update domain in Coolify resource settings
3. Enable SSL (Let's Encrypt auto-configured)

Verification

Check Container Status

ssh -i /​path/​to/​key.pem <user>@<instance-ip> \
  "sudo docker ps --format 'table {{.Names}}\t{{.Ports}}\t{{.Status}}'"

Test Application

# Get app URL from Coolify UI
APP_URL="http://<container-id>.<public-ip>.sslip.io"

curl -s $APP_URL/
curl -s $APP_URL/​health

Check Logs

# Application logs
ssh -i /​path/​to/​key.pem <user>@<instance-ip> \
  "sudo docker logs <container-name> --tail 50"

# Coolify logs
ssh -i /​path/​to/​key.pem <user>@<instance-ip> \
  "sudo docker logs coolify --tail 50"

Configuration Reference

Coolify Containers

Important Paths

Environment Variables (Installation)

Production Checklist

• Create admin account immediately after install
• Backup /​data/​coolify/​source/​.env to secure location
• Configure firewall/​security group rules
• Set up custom domain with SSL
• Restrict SSH access to specific IPs
• Configure monitoring/​alerts
• Test deployment rollback procedure
• Document access credentials securely

Troubleshooting

Update Coolify

ssh -i /​path/​to/​key.pem <user>@<instance-ip> \
  "cd /​data/​coolify/​source && sudo bash upgrade.sh"

Cleanup

# Stop all containers
ssh -i /​path/​to/​key.pem <user>@<instance-ip> \
  "cd /​data/​coolify/​source && sudo docker compose down"

# Remove Coolify data (destructive)
ssh -i /​path/​to/​key.pem <user>@<instance-ip> \
  "sudo rm -rf /​data/​coolify"

# Terminate cloud instance

References

• Coolify Documentation
• Coolify Installation Guide
• Coolify GitHub
• Traefik Documentation
• sslip.io