Coolify Kurulumu: Sunucu Hazırlığından İlk Dağıtıma

Kısa cevap: Coolify kurulumu, resmi kurulum betiğinin çalıştırılmasıyla tek komutta biten bir işlemdir; belirleyici olan kurulumdan önce ve sonra yapılanlardır. Öncesinde sunucu sertleştirmesi tamamlanmalı (SSH anahtarı, parola girişinin kapatılması, varsayılan kapalı firewall). Sonrasında panel erişimi VPN veya kaynak IP ile kısıtlanmalı, alan adı ve TLS sertifikası tanımlanmalı, kalıcı veri ile yedekleme kurgusu kurulmalıdır.

Coolify kurmadan önce sunucuda ne yapılmalı?

Coolify bir yönetim katmanıdır; sunucunun güvenliğini üstlenmez. Kurulumdan önce şu altı adım tamamlanmış olmalı:

1. Sistem güncellemesi yapıldı.
2. sudo yetkili ayrı bir kullanıcı açıldı.
3. SSH anahtarı yerleştirildi ve ikinci bir terminalden giriş doğrulandı.
4. Root ve parola ile SSH girişi kapatıldı.
5. Firewall varsayılan kapalı kuruldu, yalnız gerekli portlar açık.
6. Otomatik güvenlik güncellemesi etkin.

Bu altı adımın komut karşılığı ve doğrulama yöntemi VPS ilk 30 dakika kontrol listesinde; erişim katmanının derinliği SSH sertleştirme rehberinde.

Kaynak tarafında pratik gözlem: imaj derleme, kurulumun en çok bellek tüketen adımıdır. Düşük bellekli sunucularda uygulama sorunsuz çalışır ama derleme adımı başarısız olur ve hata mesajı genellikle uygulama hatası gibi görünür. Derleme sırasında takas alanı olmayan küçük sunucularda bu sorun daha sık çıkar. Güncel donanım gereksinimleri için resmi dokümana bakın; başlangıç için 2 çekirdek ve 4 GB bellek makul bir hedeftir.

Disk tarafında da bir uyarı: her dağıtım yeni imaj katmanları üretir ve bunlar birikir. Disk doluluğunu izlemek ve düzenli temizlik yapmak gerekir; eşikler ve uyarı kurgusu için sunucu izleme rehberine bakın.

Coolify nasıl kurulur?

Kurulum tek komutla yapılır. Ancak internetten indirilen bir betiği doğrudan kabuğa yöneltmek yerine, önce indirip okumak daha iyi bir alışkanlıktır:

# Betiği indir ve içeriğine bak
curl -fsSL https://cdn.coollabs.io/coolify/install.sh -o coolify-install.sh
less coolify-install.sh

# Okuduktan sonra çalıştır
sudo bash coolify-install.sh

Betiğin güncel adresini resmi dokümandan doğrulayın; üçüncü taraf blog yazılarındaki bağlantıları kullanmayın. Kurulum betiği sunucuya Docker’ı kurar (kurulu değilse), gerekli konteynerleri indirir ve paneli ayağa kaldırır.

Kurulum bittiğinde panel varsayılan olarak yüksek bir port üzerinden erişilebilir olur (çıktıda adres yazar). İlk açılışta yönetici hesabını oluşturursunuz. İlk hesabı oluşturana kadar panel korumasızdır, bu yüzden kurulumun hemen ardından bu adımı tamamlayın; sunucu internete açıksa bu aralık kritiktir.

Firewall tarafında panel portunu herkese açmayın. Doğru kurgu, panele yalnız VPN veya bilinen bir IP üzerinden erişmektir:

# Panel portunu yalnız yönetim IP'sine aç (port numarasını kendi kurulumunuza göre yazın)
sudo ufw allow from 203.0.113.10 to any port 8000 proto tcp

# Web trafiği herkese açık kalır
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

Firewall kurallarının doğru sırayla uygulanması ve kendinizi kilitlememek için Linux firewall rehberine bakın.

Kurulumdan sonra panel nasıl güvenceye alınır?

Panel, sunucudaki tüm uygulamalara, ortam değişkenlerine ve veritabanı parolalarına erişim verir. Kurulumdan sonra ilk üç iş şudur:

1. Panele alan adı ve sertifika bağlayın. IP ve şifrelenmemiş bağlantı üzerinden panel kullanmak, oturum bilgisini ağda açık taşımaktır. Nasıl yapıldığı Coolify domain ve SSL yapılandırması yazısında.

2. İki faktörlü kimlik doğrulamayı etkinleştirin. Panel parolası tek savunma olmamalıdır.

3. Erişimi kısıtlayın. Tercih sırasıyla: VPN arkasına alın, kaynak IP kısıtı koyun, en kötü ihtimalle güçlü kimlik doğrulama ile açık bırakın. VPN kurulumu için WireGuard site-to-site veya CGNAT arkasındaysanız ZeroTier yazılarına bakabilirsiniz.

Bir de sık atlanan dördüncü madde var: Coolify’ın kendi verisi de yedeklenmelidir. Panelin veritabanı, uygulama tanımlarınızı, ortam değişkenlerinizi ve sunucu bağlantılarınızı tutar. Bu veri kaybolursa uygulamalarınız çalışmaya devam eder ama yönetim katmanını sıfırdan kurmanız gerekir. Yedekleme kurgusu için Docker veri kalıcılığı ve sanallaştırma üzerinde çalışıyorsanız Proxmox yedekleme rehberine bakın.

Git deposu Coolify’a nasıl bağlanır?

Coolify, depo sağlayıcınıza iki şekilde bağlanabilir:

• Uygulama entegrasyonu (önerilen): Depo sağlayıcısında bir uygulama tanımlanır, Coolify’a yetki verilir. Webhook’lar otomatik kurulur, kod gönderdiğinizde dağıtım kendiliğinden başlar.
• Dağıtım anahtarı (deploy key): Coolify bir SSH anahtarı üretir, siz bunu depoya salt okunur erişimle eklersiniz. Webhook’u elle tanımlamanız gerekir.

Özel depolarda ikisi de çalışır; entegrasyon yolu daha az elle iş gerektirir. Her iki durumda da yetkinin yalnız gereken depolara verildiğinden emin olun; tüm hesaba erişim yetkisi vermek gereksiz risktir.

Dal (branch) seçimine dikkat edin. Uygulama tanımında hangi dalın dağıtılacağı belirtilir ve bu ayar sessiz bir tuzak kaynağıdır: yerelde main dalında çalışırken uygulama master dalını dinliyorsa, kodu gönderirsiniz ve hiçbir şey olmaz. Dağıtım tetiklenmiyorsa ilk bakılacak yer budur.

Aynı sınıftan bir başka tuzak: bir depoyu birden fazla ortamda (üretim ve hazırlık) kullanıyorsanız, her uygulamanın hangi dala baktığını açıkça kaydedin. Uzun süre dokunulmamış bir uygulamanın hangi dalı dinlediğini hatırlamak zordur ve yanlış dalın üretime gitmesi, fark edilmesi en geç sorunlardandır.

İlk uygulama nasıl dağıtılır?

Uygulama oluştururken verilecek kararlar:

Derleme yöntemi. Depoda Dockerfile varsa Coolify onu kullanır; yoksa otomatik algılamayla imaj üretmeye çalışır. Otomatik algılama pratiktir ama kontrolü elinizde tutmak isterseniz kendi Dockerfile dosyanızı yazın: hangi taban imaj, hangi sürüm ve hangi adımlar çalışacağını siz belirlersiniz. Üretimde öngörülebilirlik, kolaylıktan daha değerlidir.

Ortam değişkenleri. Panelden tanımlanır. İki ayrım önemlidir: derleme sırasında mı yoksa çalışma zamanında mı gerekli? Ön uç çatılarının çoğu, ortam değişkenlerini derleme sırasında koda gömer; çalışma zamanı değişkeni olarak tanımlarsanız uygulamada boş görünür. Bir değişkenin uygulamaya ulaşmadığını düşündüğünüzde ilk bakılacak yer bu ayrımdır.

Kalıcı depolama. Uygulama dosya yüklüyorsa veya durum tutuyorsa, bu veri için kalıcı depolama tanımlamanız gerekir. Konteyner her dağıtımda yeniden oluşturulur ve içine yazılan veri kaybolur. Bu konu yeterince tuzaklı olduğu için ayrı bir yazıda ele aldım: Coolify kalıcı veri tuzakları.

Sağlık kontrolü. Uygulamanın hazır olduğunu bildiren bir uç nokta tanımlayın. Bu, dağıtım sırasında yeni sürümün gerçekten ayağa kalktığını doğrular; tanımlanmadığında konteyner çalışıyor ama uygulama cevap vermiyor olabilir. Sağlık kontrolü mantığının ayrıntısı Docker Compose üretim rehberinde.

Dağıtım başarısız olduğunda nereye bakılır?

Sorunu katman katman daraltın.

1. Panelin dağıtım günlüğü. Derleme hatası burada görünür. Bağımlılık yükleme hatası, derleme komutunun başarısız olması veya Dockerfile sorunları bu adımda çıkar.

2. Konteyner günlüğü. Derleme başarılı ama uygulama açılışta çöküyorsa buraya bakılır. En yaygın sebepler: eksik ortam değişkeni, erişilemeyen veritabanı, kullanılan port çakışması.

3. Sunucu kaynakları. Derleme sırasında yetersiz bellek ve dolu disk, uygulama hatası gibi görünen mesajlar üretir:

# Disk doluluğu
df -h

# Docker'ın disk kullanımı (imaj katmanları hızla birikir)
docker system df

# Bellek durumu
free -h

# Konteyner kaynak kullanımı
docker stats --no-stream

Disk dolmuşsa kullanılmayan imaj katmanlarını temizleyin, ancak ne sileceğinizi görerek:

# Önce ne kadar yer kaplıyor, neler kullanılmıyor
docker system df -v

# Kullanılmayan imaj ve derleme önbelleğini temizle (hacimlere dokunmaz)
docker image prune -a
docker builder prune

--volumes seçeneğini bu komutlarda kullanmayın; kullanılmayan görünen bir hacim, geçici olarak durdurulmuş bir servisin verisi olabilir. Ayrıntısı Docker veri kalıcılığı yazısında.

4. Ağ ve alan adı. Uygulama ayakta ama tarayıcıdan erişilemiyorsa sorun yönlendirme veya sertifika tarafındadır: Coolify domain ve SSL yapılandırması.

Zamanlanmış görevler neden sessizce başarısız olur?

Coolify, konteyner içinde zamanlanmış görevler çalıştırmanıza izin verir (yedekleme, temizlik, veri çekme). Burada dikkat edilecek bir nokta var: görev, uygulamanın kendi adresine bir istek atıyorsa, o adresin konteyner içinden gerçekten çözülebildiğini doğrulayın.

Konteyner içinde localhost adresi, ana sistemi değil konteynerin kendisini gösterir. Ayrıca bazı ortamlarda localhost adı önce IPv6 adresine çözülür; uygulama yalnız IPv4 üzerinde dinliyorsa bağlantı sessizce başarısız olur ve görev hiçbir çıktı üretmeden başarısız görünür. Bu tür bir görev yazarken adresi açıkça belirtmek (127.0.0.1 veya servis adı) tahmin etmekten daha güvenlidir.

Genel kural: zamanlanmış görevi yazdıktan sonra bir kez elle çalıştırıp çıktısını görün. Sessizce başarısız olan bir görev, aylarca çalışıyor sanılabilir.

Kurulum sonrası kontrol listesi

• Sunucu sertleştirmesi Coolify’dan önce tamamlandı
• Yönetici hesabı kurulumun hemen ardından oluşturuldu
• Panel portu firewall’da kısıtlı (VPN veya kaynak IP)
• Panele alan adı bağlandı, HTTPS çalışıyor
• İki faktörlü kimlik doğrulama etkin
• Git bağlantısı yalnız gereken depolara yetkili
• Her uygulamanın dinlediği dal doğrulandı ve kayıtlı
• Kalıcı depolama gereken uygulamalarda tanımlar yapıldı
• Sağlık kontrolü uç noktaları tanımlı
• Coolify’ın kendi verisi yedekleme kapsamında
• Disk doluluğu izleniyor, imaj temizliği planlı
• Zamanlanmış görevler en az bir kez elle çalıştırılıp doğrulandı

Kurulum tamamlandığında sıradaki iki konu alan adı ve sertifika yönetimi ile kalıcı veridir: Coolify domain ve SSL ve Coolify kalıcı veri tuzakları. Coolify’ın ne yapıp ne yapmadığının genel çerçevesi Coolify nedir yazısında; altındaki sunucu katmanlarının tamamı Linux sunucu yönetimi yol haritasında.

Dağıtım altyapısının kurulumu ve devri için cloud çözümleri hizmet sayfasına bakabilirsiniz.

Kaynaklar

• Coolify Installation (güncel kurulum adımları ve gereksinimler)
• Install Docker Engine (altta çalışan konteyner motoru)
• sshd_config manual page (kurulum öncesi erişim sertleştirmesi)