Coolify

Description

Coolify 1-Click Application on EasyCloudify

Deploy Coolify, an open-source and self-hostable alternative to Heroku, Netlify, and Vercel. Coolify simplifies deploying and managing your applications, databases, and services on your own infrastructure with complete control over your data and costs.

What is Coolify?

Coolify is a powerful platform that makes it easy to deploy and manage applications on your own server without needing to be a DevOps expert. It provides a user-friendly interface for deploying static sites, Node.js applications, Docker containers, databases, and more.

Built with modern technologies and focused on developer experience, Coolify offers:

• Application Deployment - Deploy from Git repositories (GitHub, GitLab, Bitbucket), Docker images, or Dockerfiles
• Database Management - PostgreSQL, MySQL, MongoDB, Redis, and more with automated backups
• Automatic SSL/TLS - Free SSL certificates via Let's Encrypt with automatic renewal
• Built-in CI/CD - Automatic deployments on git push
• Domain Management - Easy custom domain configuration
• Environment Variables - Secure management of secrets and configurations
• Docker-based - Runs everything in isolated containers for security and reliability
• Self-hosted - Complete control over your data, no vendor lock-in

Key Features

• Deploy multiple applications and services on a single server
• Support for static sites, Node.js, PHP, Python, Ruby, Go, and more
• One-click deployment of popular services (WordPress, Ghost, Plausible, etc.)
• Real-time deployment logs and monitoring
• Team collaboration features
• Webhook support for custom integrations
• Resource monitoring and management
• Built-in reverse proxy with Traefik
• Automated backup and restore capabilities
• Multi-server support (manage multiple servers from one interface)

System Requirements

Coolify is packaged as Docker containers and runs on your EasyCloudify VPS. Choose the appropriate VPS size based on your needs:

Minimum Requirements (Coolify Only)

• CPU: 2 cores
• RAM: 2 GB
• Storage: 30 GB

Recommended for Production Workloads

Applications/Services	RAM	CPU	Storage
1-3 small apps	4GB	2 CPU	50GB
5-10 apps + databases	8GB	4 CPU	100GB
10+ apps + services	16GB+	8 CPU	150GB+
_
Note: The VPS size needed depends on what you'll deploy. Monitor resource usage and scale up as needed._

Included System Components

This 1-Click installs and configures the following components:

• Ubuntu 24.04 LTS - Long-term support base operating system
• Docker Engine 24+ - Container runtime for running applications
• Docker Compose Plugin - Multi-container application management
• Coolify Latest - The Coolify platform and web interface
• UFW Firewall - Pre-configured with secure defaults
• Required utilities - curl, wget, git, jq, openssl for operations

Getting started after deploying Coolify

Initial Setup

1. Deploy the VPS

• Select this 1-Click App from the EasyCloudify Marketplace
• Choose a VPS size (minimum 2 CPU / 2GB RAM recommended)
• Select your preferred datacenter region
• Add your SSH key for secure access
• Create the VPS

2. First SSH Login

• SSH into your VPS: ssh root@your-vps-ip
• An interactive setup wizard will appear automatically
• You'll be prompted: "Would you like to activate localhost now?"
• Choose Yes (recommended) to enable deployments immediately
• The setup activates SSH keys and restarts Coolify
• This only runs once on first login

3. Access Coolify Web Interface

• Navigate to http://your-vps-ip:8000 in your web browser
• You'll be redirected to the registration page

4. Create Admin Account

• CRITICAL: Create your admin account immediately
• The first user to register gets full administrative access
• Use a strong password and save your credentials securely
• The localhost server should now show as connected

5. Start Deploying

• Create your first project
• Deploy applications, databases, or services
• Configure domains and SSL certificates

Note: If you skipped localhost activation during first login, you can activate it anytime by running:

bash
Copy
/opt/configure-coolify-localhost.sh

Setting Up a Custom Domain (Recommended)

For production use with automatic HTTPS:

1. Configure DNS

• In your DNS provider, create an A record pointing to your VPS's IP
• Example: coolify.yourdomain.com your-VPS-ip
• Wait for DNS propagation (5-15 minutes)

2. Update Coolify Settings

• Log in to Coolify web interface
• Go to Settings Configuration
• Update the instance URL to your domain
• Coolify will automatically configure SSL/TLS

3. Deploy Your First Application

• Create a new project in Coolify
• Add a resource (application, database, or service)
• Connect your Git repository or use a Docker image
• Configure your domain and environment variables
• Deploy!

Managing Coolify

Convenient management scripts are installed in /opt/:

Start Coolify:

/opt/start-coolify.sh

Stop Coolify:

/opt/stop-coolify.sh

Restart Coolify:

/opt/restart-coolify.sh

Update to Latest Version:

/opt/update-coolify.sh

View Real-time Logs:

/opt/coolify-logs.sh

Check Service Status:

/opt/coolify-status.sh

Using systemctl

Coolify is also available as a systemd service:

Start the service:

systemctl start coolify

Stop the service:

systemctl stop coolify

Restart the service:

systemctl restart coolify

Check service status:

systemctl status coolify

Enable on boot (already enabled):

systemctl enable coolify

Configuration and Locations

Important Directories

• Main Directory: /data/coolify/
• Configuration: /data/coolify/source/.env
• Docker Compose: /data/coolify/source/docker-compose.yml
• Applications: /data/coolify/applications/
• Databases: /data/coolify/databases/
• Backups: /data/coolify/backups/
• SSH Keys: /data/coolify/ssh/keys/

Firewall Configuration

UFW firewall is pre-configured with the following ports:

• 22 (SSH) - Limited rate to prevent brute force
• 80 (HTTP) - For web traffic and Let's Encrypt validation
• 443 (HTTPS) - For secure web traffic
• 8000 (Coolify UI) - Coolify web interface
• 6001 (Coolify Realtime) - Real-time updates
• 6002 (Coolify Soketi) - WebSocket server

Add custom ports (if needed for your applications):

javascript
Copy
ufw allow 3000/tcp comment 'Custom App'

Deploying Applications

From Git Repository

1. In Coolify, create a new Application resource
2. Select "Public Repository" or connect your Git provider
3. Enter your repository URL
4. Configure build settings (Coolify auto-detects most frameworks)
5. Set environment variables if needed
6. Configure your domain
7. Click Deploy

From Docker Image

1. Create a new Application resource
2. Select "Docker Image"
3. Enter the image name (e.g., nginx:latest)
4. Configure ports and volumes
5. Set environment variables
6. Click Deploy

One-Click Services

Coolify includes one-click deployments for popular services:

• WordPress, Ghost, Plausible Analytics
• PostgreSQL, MySQL, MongoDB, Redis
• MinIO, Uptime Kuma, n8n
• And many more...

Backup and Maintenance

Automated Backups

Configure automated backups in Coolify:

1. Go to your database or application settings
2. Navigate to the "Backups" tab
3. Configure backup frequency and retention
4. Set up S3-compatible storage (optional)

Manual Backup

Backup configuration and data:

cd /data/coolify
tar -czf coolify-backup-$(date +%Y%m%d).tar.gz source/ databases/ applications/

Updates

Keep Coolify up to date with:

/opt/update-coolify.sh

Or manually:

cd /data/coolify/source
bash upgrade.sh

Troubleshooting

Coolify won't start

Check Docker status:

systemctl status docker
docker ps

View Coolify logs:

/opt/coolify-logs.sh

Can't access web interface

Check if Coolify is running:

/opt/coolify-status.sh

Verify firewall:

ufw status

Out of resources

Check resource usage:

docker stats
df -h
free -h

Consider upgrading your VPS if consistently at high usage.

Reset admin password

Access the database container and reset:

cd /data/coolify/source
docker compose exec postgres psql -U coolify
# Follow password reset procedure in Coolify docs

Security Best Practices

1. Change default port: Consider moving Coolify to a non-standard port
2. Use SSH keys: Disable password authentication for SSH
3. Enable 2FA: Enable two-factor authentication in Coolify settings
4. Regular updates: Keep Coolify and the system updated
5. Backup regularly: Configure automated backups
6. Use HTTPS: Always use SSL/TLS for production applications
7. Monitor logs: Regularly review application and system logs
8. Limit access: Use Coolify's team features to control access

Additional Resources

1. Official Documentation: https://coolify.io/docs
2. Community Support: https://coolify.io/discord
3. GitHub Repository: https://github.com/coollabsio/coolify
4. Video Tutorials: https://www.youtube.com/@coolify-io

Support

For Coolify-specific issues:

• Documentation: https://coolify.io/docs
• Discord Community: https://coolify.io/discord
• GitHub Issues: https://github.com/coollabsio/coolify/issues

Note: This 1-Click uses the official Coolify installation method and follows the recommended configuration for Ubuntu 24.04 LTS. All components are open-source and maintained by the Coolify community.