Coolify Connection Troubleshooting

Solutions for common Coolify connection issues

Connection Issues

If you're experiencing connection problems with Coolify, here are the most common causes and solutions:

1. Firewall Configuration

The most common issue is firewall blocking access to Coolify ports. Coolify requires several ports to be open:

  • Port 80 - HTTP traffic
  • Port 443 - HTTPS traffic
  • Port 22 - SSH access (if needed)
  • Port 3000 - Default NextCoder app port

For Ubuntu/Debian (UFW):

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 22/tcp
sudo ufw allow 3000/tcp
sudo ufw enable

For CentOS/RHEL (firewalld):

sudo firewall-cmd --permanent --add-port=80/tcp
sudo firewall-cmd --permanent --add-port=443/tcp
sudo firewall-cmd --permanent --add-port=22/tcp
sudo firewall-cmd --permanent --add-port=3000/tcp
sudo firewall-cmd --reload

2. Docker Installation Issues

Coolify requires Docker to be properly installed. If Docker isn't installed or running:

# Install Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# Add current user to docker group
sudo usermod -aG docker $USER

# Start Docker service
sudo systemctl start docker
sudo systemctl enable docker

3. Coolify Installation Verification

Check if Coolify is properly installed and running:

# Check if Coolify containers are running
docker ps | grep coolify

# Check Coolify logs
docker logs coolify

# Restart Coolify if needed
docker restart coolify

4. Network Configuration

Ensure your server's network configuration allows external connections:

# Check network interfaces
ip addr show

# Check if server can reach the internet
ping -c 4 google.com

# Check if ports are listening
netstat -tlnp | grep :80
netstat -tlnp | grep :443

5. Reinstalling Coolify

If the above steps don't work, try reinstalling Coolify:

# Remove existing Coolify installation
curl -fsSL https://cdn.coollabs.io/coolify/uninstall.sh | bash

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

Advanced Troubleshooting

Check System Resources

Ensure your server has sufficient resources:

# Check available memory
free -h

# Check disk space
df -h

# Check CPU usage
top

SSL Certificate Issues

If you're having SSL issues, check certificate generation:

# Check Let's Encrypt logs
docker logs coolify-nginx

# Renew certificates manually
docker exec coolify-nginx certbot renew

Database Connection Issues

If your application can't connect to the database:

# Check database container
docker ps | grep postgres

# Check database logs
docker logs coolify-db

# Test database connection
docker exec -it coolify-db psql -U nextcoder -d nextcoder_db

Need More Help?

If you're still experiencing issues: