Coolify Nedir? Sunucuya Kurulumu Adım Adım

Bir uygulamayı canlıya almak için Heroku, Vercel yada Netlify gibi platformlar çok rahat ama proje büyüdükçe faturalar da büyüyor. Kendi sunucunuzda aynı rahatlığı isteyenler için son yıllarda en çok konuşulan araçlardan biri Coolify. Bu yazıda Coolify nedir, ne işe yarar, alternatiflerinden farkı ne ve Coolify sunucuya nasıl kurulur sorularını adım adım cevaplıyoruz. Kurulumdan sonra ilk uygulamayı yayına almayı, veritabanı eklemeyi ve güvenlik ayarlarını da anlatacağız.

Coolify Nedir?

Coolify, kendi sunucunuza kurduğunuz açık kaynak ve ücretsiz bir PaaS (Platform as a Service) yazılımı. Kısaca Heroku/Vercel benzeri bir paneli kendi sanal sunucunuzda çalıştırıyorsunuz: Git deponuzu bağlıyorsunuz, Coolify uygulamayı derliyor, konteyner olarak çalıştırıyor, alan adını bağlayıp SSL sertifikasını otomatik alıyor. Her git push sonrası yeni sürüm kendiliğinden yayına çıkabiliyor.

Arka planda herşey Docker konteynerleri ile çalışıyor; Coolify bu konteynerleri, ters vekil sunucuyu (reverse proxy), sertifikaları ve yedekleri sizin yerinize yöneten bir yönetim katmanı. Proje GitHub'da on binlerce yıldızı olan aktif bir topluluğa sahip; uzun süren beta döneminden sonra v4 sürümü 2026 baharında kararlı (stable) hale geldi ve yazıyı yazdığımız sırada 4.4.x serisi kullanılıyor.

Coolify, Heroku/Vercel ve Düz Docker Karşılaştırması

Özetle Coolify, düz Docker'ın maliyet ve kontrol avantajını Heroku'nun kullanım kolaylığıyla birleştiriyor. Karşılığında sunucunun güncellemesi, yedeklerin kontrolü gibi işler size kalıyor.

Coolify'ın Öne Çıkan Özellikleri

Coolify Sistem Gereksinimleri

Coolify Kurulumu: Adım Adım

Aşağıdaki adımları temiz kurulu bir Ubuntu 24.04 sunucuda, root kullanıcısı ile yaptık. Henüz bir sunucunuz yoksa önce bulut sunucu nedir yazımıza göz atabilirsiniz.

1. Sunucuyu Hazırlayın

Sistemi güncelleyin ve snap ile kurulmuş bir Docker varsa kaldırın; Coolify snap Docker ile çalışmıyor:

apt update && apt upgrade -y

# snap ile kurulmuş Docker varsa kaldırın (Coolify desteklemiyor)
snap list docker 2>/dev/null && snap remove docker

# curl yoksa kurun
apt install -y curl

2. Kurulum Betiğini Çalıştırın

Resmi kurulum betiği Docker'ı (yoksa) kuruyor, gerekli dizinleri oluşturuyor ve Coolify konteynerlerini başlatıyor. Tek komut:

curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash

Kurulum sunucu hızına göre birkaç dakika sürüyor. Bittiğinde konteynerlerin ayakta olduğunu kontrol edebilirsiniz:

docker ps --format "table {{.Names}}\t{{.Status}}"   # coolify konteynerleri çalışıyor mu?
docker logs coolify --tail 50                         # bir sorun varsa loglara bakın

3. Paneli Açın ve Yönetici Hesabını Oluşturun

Tarayıcıdan aşağıdaki adrese gidin:

http://SUNUCU_IP:8000

İlk girişte Coolify kısa bir başlangıç sihirbazı gösteriyor. Uygulamaları aynı sunucuda çalıştıracaksanız "localhost" sunucusunu seçmeniz yeterli.

4. Alan Adı ve SSL Ayarı

DNS panelinizden panel ve uygulamalar için A kayıtlarını sunucunun IP'sine yönlendirin:

# panel ve uygulama için A kayıtları
coolify.ornek.com   A   SUNUCU_IP
app.ornek.com       A   SUNUCU_IP

# isteğe bağlı: her uygulamaya otomatik alt alan adı için wildcard
*.ornek.com         A   SUNUCU_IP

Ardından Coolify'da Settings bölümündeki instance domain alanına https://coolify.ornek.com yazıp kaydedin. Traefik, Let's Encrypt sertifikasını otomatik alıyor; birkaç dakika içinde panel HTTPS ile açılıyor. Wildcard kaydı eklediyseniz sunucu ayarlarındaki wildcard domain alanını doldurarak her uygulamaya otomatik alt alan adı verilmesini sağlayabilirsiniz.

5. İlk Uygulamayı Deploy Edin

1. Projects altında yeni bir proje oluşturun, ardından + New ile bir kaynak (resource) ekleyin.
2. Herkese açık bir repo için "Public Repository", özel repo için GitHub App veya deploy key seçeneğini kullanın.
3. Build yöntemi olarak Nixpacks çoğu Node.js, Python, PHP, Go projesinde ekstra ayar gerektirmeden çalışıyor; projede Dockerfile yada docker-compose.yml varsa onu da seçebilirsiniz.
4. Domains alanına https://app.ornek.com yazın, gerekiyorsa uygulamanın dinlediği portu ve ortam değişkenlerini (environment variables) girin.
5. Deploy butonuna basın. Build logları canlı olarak akıyor; bittiğinde uygulama SSL ile yayında.

Otomatik deploy açıksa bundan sonra repoya her push'ta yeni sürüm kendiliğinden çıkıyor. Daha gelişmiş test ve onay adımları içeren bir süreç kurmak isterseniz CI/CD pipeline danışmanlığı hizmetimize de bakabilirsiniz.

6. Veritabanı Ekleyin

Aynı projede + New → Database diyerek PostgreSQL, MySQL, Redis gibi bir veritabanını seçin. Coolify kullanıcı adı ve şifreyi kendisi oluşturup bağlantı adresini veriyor; bu adresi uygulamanın ortam değişkenine eklemeniz yeterli. Veritabanını dışarı açmanız gerekmiyor, aynı sunucudaki uygulamalar iç ağ üzerinden bağlanıyor. Yedekleme sekmesinden günlük yedek ve S3 hedefi tanımlamayı unutmayın.

Güvenlik ve Güvenlik Duvarı

Dışarıya sadece gerçekten gereken portları açın. SSH (22), HTTP (80) ve HTTPS (443) yeterli; 8000 portunu sadece ilk kurulum için açıp panel alan adı ve SSL ile çalışmaya başladıktan sonra kapatabilirsiniz:

ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw allow 8000/tcp     # panel domain + SSL ayarlanana kadar
ufw enable

# panel HTTPS ile açıldıktan sonra 8000'i kapatın
ufw delete allow 8000/tcp

Panelin terminal ve canlı bildirim gibi özellikleri ek portlar kullanabiliyor; güvenlik duvarını kısıtlarken Coolify'ın resmi dokümantasyonundaki firewall sayfasını kontrol edin. Bunun dışında birkaç öneri:

• SSH'ta şifreli girişi kapatıp anahtar ile girişe geçin.
• Yönetici hesabında iki adımlı doğrulamayı açın.
• Veritabanlarını "public" yapmayın; gerekiyorsa sadece belirli IP'lere izin verin.
• Coolify'ı ve işletim sistemini düzenli güncelleyin. Panelden güncelleme yapılabiliyor, kurulum betiği de mevcut kurulumu güncelliyor:

curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash   # aynı betik mevcut kurulumu günceller

Sık Karşılaşılan Sorunlar

Küçük sunucularda build sırasında bellek sorunu yaşıyorsanız 4 GB'lık bir swap dosyası çoğu zaman yetiyor:

fallocate -l 4G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab

Coolify İçin Hangi VECDC Paketi?

Birkaç küçük uygulama ve bir veritabanı için VPS-1 (2 Core, 8 GB RAM, 40 GB NVMe) Coolify'ın gereksinimlerini rahatça karşılıyor. Birden fazla proje, ağır build'ler yada birkaç veritabanı çalıştıracaksanız VPS-2 (4 Core, 12 GB) veya VPS-3 (4 Core, 16 GB) daha rahat bir başlangıç. VECDC sanal sunucuları adanmış CPU, NVMe disk ve 1 Gbps bağlantı ile aylık $6'dan başlıyor, otomatik kurulumla yaklaşık 5 dakikada hazır oluyor ve lokasyonu sipariş sırasında seçebiliyorsunuz.

Developer VDS paketlerimizde Docker hazır kurulu geliyor. Coolify kurulum betiği mevcut Docker'ı algılayıp kullanıyor; malesef her özel yapılandırmayla uyumlu olacağının garantisi yok, bu yüzden en sorunsuz yol Coolify'ı temiz bir sunucuya kurmak.

Sık Sorulan Sorular

Kısacası

Coolify, Heroku ve Vercel'in kolaylığını kendi sunucunuza getiren ücretsiz, açık kaynak bir PaaS. Tek komutla kuruluyor, Git deponuzu bağlayıp uygulamanızı SSL ile dakikalar içinde yayına alıyor, veritabanı ve yedekleri de aynı panelden yönetiyor. Sabit aylık ücretli bir VPS üzerinde birden fazla projeyi kontrolü elinizde tutarak çalıştırmak için gayet mantıklı bir seçenek. Kurulumda takıldığınız birşey olursa bize yazın.