Coolify Nedir? Nasıl Kullanılır ve Nelere Yarar?

Yaklaşık 4 dakikalık okuma

Bir web uygulamasını yayına almak için Heroku, Vercel veya Netlify gibi platformlar çok pratiktir; ancak proje sayısı arttıkça faturalar da büyür ve verileriniz başkasının altyapısında durur. Coolify, bu platformların sunduğu kolaylığı kendi sunucunuzda sunan açık kaynaklı bir araçtır. Bu yazıda Coolify’ın ne olduğunu, nasıl kurulduğunu ve hangi işlerde kullanılabileceğini anlatıyorum.

Coolify Nedir?

Coolify, kendi sunucunuza kurduğunuz (self-hosted) açık kaynaklı bir PaaS (Platform as a Service) çözümüdür. Arka planda Docker kullanır ve size web tabanlı bir yönetim paneli sunar. Bu panel üzerinden:

  • Git deposundaki projenizi birkaç tıkla yayına alabilir,
  • Alan adı bağlayıp otomatik Let’s Encrypt SSL sertifikası alabilir,
  • PostgreSQL, MySQL, MariaDB, MongoDB ve Redis gibi veritabanlarını oluşturabilir,
  • WordPress, n8n, Uptime Kuma, Plausible gibi yüzlerce hazır servisi tek tıkla kurabilirsiniz.

Kısacası, normalde Nginx yapılandırması, SSL yenileme, Docker komutları ve yedekleme betikleriyle uğraşarak yapacağınız işleri tek bir arayüzde toplar.

Neden Coolify?

ÖzellikCoolifyYönetilen PaaS (Vercel, Heroku vb.)
MaliyetYazılım ücretsiz, sadece sunucu ücretiKullanıma ve proje sayısına göre artar
Veri kontrolüTamamen sizdeSağlayıcıda
Proje sayısıSunucu kaynakları yettiği sürece sınırsızPlana bağlı
BakımSunucu bakımı sizin sorumluluğunuzdaSağlayıcıda

Sunucu yönetmek istemiyorsanız Coolify ekibinin sunduğu ücretli Coolify Cloud seçeneği de vardır; bu durumda panel onların altyapısında çalışır, uygulamalarınız yine kendi sunucularınızda çalışır.

Kurulum Gereksinimleri

  • Ubuntu veya Debian gibi desteklenen bir Linux dağıtımı (temiz kurulum önerilir)
  • En az 2 CPU çekirdeği, 2 GB RAM ve 30 GB disk; birden fazla proje için 4 GB RAM ve üzeri önerilir
  • root yetkisi ve SSH erişimi
  • Bir alan adı (zorunlu değil ama SSL ve düzenli bir yapı için önerilir)

Sunucuya SSH ile güvenli bağlanmak için SSH Anahtar ile Şifresiz Giriş rehberini önceden uygulamanızı öneririm.

Kurulum: Tek Komut

Sunucuya root olarak bağlandıktan sonra resmi kurulum betiğini çalıştırın:

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

Betik; Docker’ı kurar, Coolify’ın ihtiyaç duyduğu container’ları başlatır ve işlem sonunda panel adresini gösterir. Kurulum birkaç dakika sürer.

Güvenlik notu: İnternetten indirilen bir betiği doğrudan çalıştırmadan önce içeriğini incelemek iyi bir alışkanlıktır. Aynı adresi tarayıcıda açarak betiğin ne yaptığını görebilirsiniz.

İlk Giriş ve Temel Ayarlar

  1. Tarayıcıda http://SUNUCU-IP:8000 adresine gidin.
  2. İlk ekranda yönetici hesabını oluşturun. Bu adımı kurulumdan hemen sonra yapın; aksi hâlde panele ilk ulaşan kişi yönetici olabilir.
  3. Settings bölümünden panel için bir alan adı belirleyin (örneğin coolify.example.com). Coolify bu alan adı için de otomatik SSL alır.
  4. Alan adınızın DNS ayarlarında bir A kaydı oluşturup sunucu IP’sine yönlendirin. Tüm uygulamalar için *.example.com şeklinde bir joker (wildcard) kayıt eklemek de işinizi kolaylaştırır.

Güvenlik Duvarı

Sunucuda UFW kullanıyorsanız SSH, HTTP ve HTTPS portlarını açmanız gerekir. Panel alan adı üzerinden HTTPS ile çalışmaya başladıktan sonra 8000 portunu dış dünyaya kapatabilirsiniz. Coolify’ın gerçek zamanlı bildirimleri ve web terminali için kullandığı ek portlar (6001, 6002) hakkında güncel bilgiyi resmi dokümantasyondan kontrol edin.

sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 8000/tcp

UFW hakkında ayrıntılı bilgi için Linux’ta UFW ile Güvenlik Duvarı Kurulumu yazısına bakabilirsiniz.

Temel Kavramlar

  • Server (Sunucu): Uygulamaların çalışacağı makine. Coolify kendi kurulu olduğu sunucuyu (localhost) varsayılan olarak ekler; SSH ile başka sunucular da ekleyebilirsiniz.
  • Project (Proje): Birbiriyle ilişkili kaynakları gruplayan klasör. Örneğin “Şirket Sitesi” projesinde web uygulaması ve veritabanı birlikte durur.
  • Environment (Ortam): Bir proje içinde production, staging gibi ayrı ortamlar.
  • Resource (Kaynak): Uygulama, veritabanı veya hazır servis.
  • Build Pack: Projenizin nasıl derleneceği. Coolify; Nixpacks (dili otomatik algılar), Dockerfile, Docker Compose ve Static (statik site) seçeneklerini destekler.

İlk Uygulamayı Yayına Almak

  1. Projects › Add ile yeni bir proje oluşturun.
  2. Add New Resource seçin ve kaynak türü olarak Public Repository seçin.
  3. GitHub depo adresini yapıştırın, dalı (branch) seçin. Build pack olarak çoğu proje için Nixpacks yeterlidir.
  4. Domains alanına uygulamanın adresini yazın, örneğin https://app.example.com.
  5. Uygulamanın gerektirdiği ortam değişkenlerini Environment Variables sekmesinden ekleyin.
  6. Deploy butonuna basın ve derleme loglarını canlı olarak izleyin.

Birkaç dakika içinde uygulamanız SSL sertifikasıyla birlikte yayında olur. Özel (private) depolar için GitHub App veya Deploy Key gerekir; bu konuyu serinin son yazısında ayrıntılı olarak ele alacağım.

Coolify ile Neler Yapılabilir?

  • Web siteleri ve API’ler: Node.js, Python, PHP, Go, Laravel, Next.js gibi neredeyse her teknolojiyle yazılmış projeler.
  • Otomatik deploy: Git deposuna her push yaptığınızda uygulamanın otomatik olarak yeniden yayınlanması.
  • Pull request önizlemeleri: Her PR için ayrı bir test adresi oluşturulması.
  • Veritabanı yönetimi ve yedekleme: Veritabanlarının zamanlanmış yedeklerini S3 uyumlu bir depolamaya göndermek.
  • Hazır servisler: WordPress, n8n, Gitea, Uptime Kuma, Minio gibi uygulamaları tek tıkla kurmak.
  • Çoklu sunucu: Tek panelden birden fazla sunucuyu yönetmek.

Dikkat Edilmesi Gerekenler

  • Coolify, kurulduğu sunucuda Docker’ı yönettiği için aynı sunucuya elle Nginx veya başka bir reverse proxy kurmak port çakışmalarına yol açar. Temiz bir sunucu kullanın.
  • Panel yönetici hesabında güçlü bir parola ve mümkünse iki adımlı doğrulama kullanın.
  • Coolify, veritabanı yedeklerini kolaylaştırsa da sunucunun kendisinin de yedeğini alın. Bu konuda rsync ve cron ile Otomatik Yedekleme yazısı yardımcı olabilir.

Sonuç

Coolify; birden fazla küçük projeyi olan geliştiriciler, ajanslar ve kendi altyapısını kontrol etmek isteyen işletmeler için bulut faturalarını düşüren güçlü bir alternatiftir. Uygun fiyatlı bir VPS ile başlayıp tüm projelerinizi tek panelden yönetebilirsiniz.