Coolify ile VDS'te Self-Host PaaS Kurulumu

Coolify ile VDS'te Self-Host PaaS Kurulumu

Uygulamalarını her ay kurumsal bir PaaS platformuna kullanıcı başına veya kaynak başına ödeme yaparak deploy eden geliştiriciler için Coolify, son birkaç yılda en çok konuşulan açık kaynak projelerden biri oldu. Mantık basit: platform olarak sunulan deploy deneyimini (Git push, otomatik build, SSL, ortam değişkenleri, log takibi) kendi sunucunuzda, kendi kontrolünüzde çalıştırmak. Bu yazıda bir VDS üzerine Coolify'ı sıfırdan kurmayı, ilk yapılandırmayı, örnek bir uygulama deploy etmeyi ve üretim ortamında dikkat edilmesi gereken güvenlik/yedekleme noktalarını adım adım anlatıyoruz.

Coolify Nedir, Neden Kendi Sunucunuzda Barındırmalısınız

Coolify, Docker tabanlı çalışan, açık kaynaklı bir self-host PaaS (Platform as a Service) aracıdır. Temelde şunu yapar: bir Git deposunu (GitHub, GitLab, Bitbucket veya kendi Git sunucunuz) bağlarsınız, Coolify kodu analiz eder, uygun build stratejisini (Dockerfile, Nixpacks, statik site, Docker Compose) seçer, imajı oluşturur, container'ı ayağa kaldırır ve arkasındaki reverse proxy üzerinden otomatik Let's Encrypt sertifikasıyla domain'inize bağlar.

Kurumsal PaaS platformlarının sunduğu deneyime çok benzer bir arayüz sağlar ama fark şurada: sunucu sizin, veri sizin, kaynak limiti sizin belirlediğiniz kadar. Aylık kullanıcı/proje başına ücret yoktur; tek maliyet üzerinde çalıştığı sunucunun maliyetidir.

Kimler için mantıklı:

• Birden fazla küçük-orta ölçekli projeyi (API, dashboard, staging ortamları, dahili araçlar) tek sunucuda toplu yönetmek isteyenler
• Ekip içi araçları (n8n, form builder'lar, admin panelleri) manuel docker run komutlarıyla değil, merkezi bir arayüzden yönetmek isteyenler
• CI/CD kurmadan Git push sonrası otomatik deploy istekleri
• Maliyet öngörülebilirliği isteyen küçük yazılım ekipleri ve freelance geliştiriciler

Büyükweb perspektifi: Coolify gibi araçlar sunucu kaynaklarını (RAM, CPU, disk I/O) doğrudan ve sürekli kullanır — build süreçleri özellikle CPU ve RAM'i anlık olarak zorlar. Paylaşımlı hosting ortamında bu tür bir kurulum pratik değildir; sürecin kendi kaynaklarına tam erişimi olan bir VDS gerekir. Kaynak tahsisi net olduğu için build sırasında "komşu hesap" kaynak çekişmesi yaşamazsınız.

VDS Seçimi ve Ön Hazırlık

Coolify'ın kendisi hafiftir ama üzerinde çalıştıracağınız uygulamalar (özellikle build aşamaları) asıl kaynak tüketimini oluşturur. Bir Node.js projesinin npm install + build adımı, bir Next.js projesinde tek başına 1-2 GB RAM tüketebilir.

Pratik bir başlangıç noktası:

Kullanım senaryosu	Önerilen vCPU	Önerilen RAM	Disk
Tek küçük proje + staging	2 vCPU	4 GB	40-60 GB SSD
3-5 orta ölçekli servis	4 vCPU	8 GB	80-100 GB SSD
Çoklu servis + veritabanları (Postgres, Redis)	6-8 vCPU	16 GB	150 GB+ SSD

Sunucu işletim sistemi olarak Coolify resmi olarak Ubuntu 22.04/24.04 ve Debian 11/12 üzerinde en stabil çalışır. Kurulumdan önce yapılacaklar:

# Sistem paketlerini güncelle
apt update && apt upgrade -y

# Zaman dilimini ve hostname'i doğrula
timedatectl set-timezone Europe/Istanbul
hostnamectl set-hostname coolify-prod

Coolify kurulum betiği Docker'ı otomatik kurar, bu yüzden Docker'ı önceden manuel kurmanıza gerek yok — hatta çakışma yaşamamak için elle kurmamanız önerilir.

Firewall tarafında açılması gereken portlar:

• 22 – SSH erişimi
• 80 / 443 – HTTP/HTTPS trafiği (Coolify'ın dahili reverse proxy'si buradan geçer)
• 8000 – Coolify yönetim paneli (kurulum sonrası ilk erişim, sonradan kendi domain'inize taşıyabilirsiniz)
• 6001 / 6002 – Coolify'ın gerçek zamanlı log/durum bildirimleri için WebSocket bağlantıları

ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw allow 8000/tcp
ufw allow 6001/tcp
ufw allow 6002/tcp
ufw enable

Firewall kurallarını sıkılaştırırken SSH bağlantınızı koparmamaya dikkat edin; portu değiştirmeden önce mutlaka yeni kuralı ekleyip test ederek ilerleyin.

Coolify Kurulum Adımları

Sunucuya SSH ile bağlandıktan sonra kurulum tek satırlık resmi betikle yapılır:

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

Betik sırasıyla şunları yapar:

1. Docker Engine ve Docker Compose plugin'ini kurar (yoksa)
2. Coolify'ın kendi yönetim container'larını (uygulama, veritabanı, proxy) ayağa kaldırır
3. Varsayılan self-signed sertifika ile panel erişimini https://SUNUCU_IP:8000 adresinde açar

Kurulum genellikle 3-5 dakika sürer. Tamamlandığında terminalde erişim adresi ve ilk kullanıcı oluşturma yönergesi görünür. Tarayıcıdan panele girdiğinizde ilk admin hesabınızı (e-posta + şifre) oluşturursunuz — bu adımı kurulumdan hemen sonra yapmanız önemlidir, çünkü panel dışa açıkken kayıtsız kalması güvenlik riski oluşturur.

# Kurulum sonrası container'ların ayakta olduğunu doğrula
docker ps --filter "name=coolify"

Coolify güncellemeleri de panel içinden tek tıkla yapılır; manuel apt upgrade ile Coolify sürümü güncellenmez, güncellemeler Coolify'ın kendi mekanizması üzerinden yürür.

Panel Üzerinden İlk Yapılandırma

Panelde ilk açılışta karşınıza çıkan Servers sekmesinde localhost (kurulumu yaptığınız VDS) zaten tanımlı gelir. Buradan doğrulama (validation) işlemini çalıştırarak Docker bağlantısının sağlıklı olduğunu teyit edin.

Sonraki adım domain bağlama. Coolify panelinin kendisini de kendi alan adınız altında çalıştırmak isterseniz:

1. DNS sağlayıcınızda panel.ornekdomain.com için sunucunuzun IP adresine giden bir A kaydı oluşturun
2. Coolify panelinde Settings → Instance Domain alanına bu domaini girin
3. Coolify otomatik olarak Let's Encrypt üzerinden SSL sertifikası talep eder ve panel HTTPS'e geçer

Uygulama bazında domain bağlama da benzer mantıkla çalışır: her deploy edilen servise ayrı bir subdomain veya domain atayabilir, sertifikaları otomatik yönetebilirsiniz. Wildcard domain kullanmak, her yeni servis için ayrı DNS kaydı uğraşını ortadan kaldırır.

Büyükweb perspektifi: Coolify panelini varsayılan :8000 portunda dışarıya açık bırakmak yerine, kurulumdan hemen sonra kendi domaininize taşımanızı ve mümkünse IP kısıtlaması veya iki faktörlü kimlik doğrulama eklemenizi öneririz. Yönetim paneli, üzerinde çalışan tüm servislerin ortam değişkenlerine (API anahtarları, veritabanı şifreleri dahil) erişebildiği için tek başına kritik bir güvenlik yüzeyidir.

Uygulama Deploy Etme: Git Entegrasyonu ve Docker Compose

Coolify'da bir uygulama deploy etmenin üç yaygın yolu vardır: Git deposundan otomatik build, hazır Docker imajından deploy, veya doğrudan Docker Compose dosyası ile çoklu servis kurulumu.

Git tabanlı deploy akışı:

1. Sources sekmesinden GitHub/GitLab hesabınızı bağlayın (OAuth veya deploy key ile)
2. New Resource → Application ile depoyu seçin, branch belirtin
3. Coolify, package.json, requirements.txt, Dockerfile gibi dosyalara bakarak build stratejisini otomatik önerir (Nixpacks veya Dockerfile)
4. Ortam değişkenlerini (DATABASE_URL, API_KEY vb.) Environment Variables sekmesinden ekleyin
5. Deploy butonuna basın; isterseniz GitHub webhook'unu etkinleştirerek her git push sonrası otomatik deploy tetikleyin

Basit bir Node.js API için örnek bir Dockerfile:

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
EXPOSE 3000
CMD ["node", "server.js"]

Daha karmaşık senaryolarda — örneğin bir uygulamanın PostgreSQL ve Redis'e ihtiyaç duyduğu durumda — Coolify'ın Docker Compose kaynak tipini kullanmak daha pratiktir:

version: "3.8"
services:
  app:
    build: .
    environment:
      - DATABASE_URL=postgresql://user:pass@db:5432/appdb
      - REDIS_URL=redis://cache:6379
    depends_on:
      - db
      - cache
  db:
    image: postgres:16-alpine
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=pass
      - POSTGRES_DB=appdb
    volumes:
      - db-data:/var/lib/postgresql/data
  cache:
    image: redis:7-alpine

volumes:
  db-data:

Coolify bu dosyayı yapıştırıp deploy ettiğinizde her servisin sağlık durumunu, loglarını ve kaynak kullanımını panelden tek ekranda izleyebilirsiniz. Container tabanlı deploy mantığına yeni başlıyorsanız, önce genel prensipleri gözden geçirmek isteyebilirsiniz: Docker ile web uygulaması deploy etme rehberimiz build/imaj/container ayrımını ve temel komutları sıfırdan anlatıyor.

Coolify'ın desteklediği "one-click" servisler arasında otomasyon araçları da var; örneğin bir iş akışı otomasyon aracını manuel Docker Compose yazmadan tek tıkla deploy edebilirsiniz. Bu tür self-host araçları Coolify dışında manuel kurmak isteyenler için n8n self-host Docker Compose kurulum rehberimiz adım adım bir örnek sunuyor — Coolify'ın arka planda otomatikleştirdiği süreci elle görmek isterseniz iyi bir referans.

Güvenlik, Yedekleme ve İzleme

Coolify'ı üretim ortamında çalıştırırken üç konu ihmal edilmemeli: erişim güvenliği, yedekleme ve izleme.

Erişim güvenliği için minimum önlemler:

• SSH'ta parola girişini kapatıp yalnızca anahtar tabanlı erişime geçin
• Coolify panelinde iki faktörlü kimlik doğrulamayı etkinleştirin
• Kaba kuvvet (brute-force) girişimlerine karşı sunucu seviyesinde koruma ekleyin

SSH ve panel giriş denemelerine karşı otomatik engelleme kurmak için Fail2ban kurulumu ve yapılandırması rehberimizi takip edebilirsiniz — tekrarlanan başarısız giriş denemesi yapan IP'leri otomatik banlayan bu araç, dışa açık bir yönetim paneli barındıran sunucularda pratikte önemli bir katman oluşturuyor.

Yedekleme konusunda iki katmanı ayırmak gerekiyor. Coolify, veritabanı servisleri için içinden zamanlanmış yedekleme (scheduled backup) tanımlamanıza izin verir ve bu yedekleri S3 uyumlu bir depolama hedefine gönderebilir. Ancak bu, container içindeki veriyle sınırlıdır; sunucunun tamamının (uygulama dosyaları, konfigürasyonlar, Coolify'ın kendi verisi) yedeklenmesi ayrı bir konudur.

# Coolify'ın kendi verisini (ayarlar, bağlı kaynaklar) manuel yedekleme örneği
docker exec coolify-db pg_dump -U coolify coolify > coolify_yedek_$(date +%F).sql

Kritik veritabanlarını sunucu dışına, şifrelenmiş şekilde düzenli olarak göndermek isteyenler için Restic ve Backblaze B2 ile şifreli yedekleme rehberimiz uygulanabilir bir strateji sunuyor.

Büyükweb perspektifi: Büyükweb VDS paketlerinde altyapı seviyesinde günlük otomatik yedekleme sağlanır; bu, sunucunuzun tamamının felaket senaryolarına karşı bir güvenlik ağıdır. Ancak Coolify üzerinde çalışan veritabanlarınızın uygulama seviyesindeki yedeklerini (özellikle sık değişen kritik veriler için) ayrıca, kendi zamanlamanızla almanız hâlâ öneriyoruz — altyapı yedeği ile uygulama içi tutarlı (consistent) yedek birbirinin yerini tam olarak tutmaz.

İzleme tarafında Coolify panelinin kendi CPU/RAM/disk grafiklerini sunar ama çoklu sunucu veya uzun vadeli trend takibi için ayrı bir izleme aracı kurmak isteyebilirsiniz. Zabbix ve Nagios ile sunucu izleme araçları rehberimiz, Coolify'ın panel dışında, disk doluluğu veya bellek sızıntısı gibi uzun vadeli metrikleri takip etmek için tamamlayıcı bir katman kurmanıza yardımcı olur.

Sık Karşılaşılan Sorunlar ve Çözümleri

Coolify kurulumlarında en sık karşılaşılan üç sorun ve çözüm yaklaşımı:

Build sırasında bellek yetersizliği: Özellikle JavaScript ekosisteminde build adımları RAM'i anlık olarak zorlar. Build sürekli belirli bir noktada takılıyorsa (npm run build sırasında container'ın sessizce kapanması gibi) önce sunucu RAM'ini, ardından swap alanını kontrol edin:

free -h
swapon --show

Swap tanımlı değilse geçici bir çözüm olarak eklemek build patlamalarını tolere etmeye yardımcı olur; kalıcı çözüm ise VDS kaynağını büyütmektir.

Reverse proxy üzerinden 502/504 hataları: Coolify'ın dahili proxy'si container ayağa kalkmadan önce trafiği yönlendirmeye çalışırsa veya container beklenenden uzun sürede başlıyorsa bu hatalarla karşılaşabilirsiniz. Bu hataların kök nedenini anlamak ve sistematik olarak çözmek için 502 Bad Gateway ve 504 Gateway Timeout hatası çözümü rehberimiz reverse proxy, upstream servis ve zaman aşımı ayarları arasındaki ilişkiyi detaylı anlatıyor.

Disk alanı dolması: Docker imaj katmanları ve kullanılmayan container'lar zamanla disk doldurur. Düzenli temizlik için:

docker system df        # Kullanım özeti
docker system prune -af # Kullanılmayan imaj/container/network temizliği

Bu komutu çalıştırmadan önce aktif kullanılan imajları etkilemediğinden emin olun; -a bayrağı bağlı olmayan tüm imajları siler.

Sunucuyu Coolify dışında SSH veya masaüstü erişimiyle yönetmeniz gerektiğinde temel bağlantı yöntemlerini gözden geçirmek isterseniz uzak masaüstü RDP bağlantısı veya Linux tabanlı sunucularda tünelleme ihtiyacı için ilgili kaynaklarımıza da göz atabilirsiniz.

Coolify'ı çalıştıracağınız sunucu seçimi, tüm bu senaryoların ne kadar sorunsuz ilerleyeceğini doğrudan belirler. Kaynak garantisi net olmayan ortamlarda build süreleri öngörülemez hâle gelir; bu yüzden Coolify gibi sürekli build/deploy döngüsü çalıştıran araçlar için dedike kaynaklı bir VDS sunucu seçmek, hem performans hem de kaynak izolasyonu açısından en tutarlı sonucu verir.

Sıkça Sorulan Sorular

Coolify kurulumu için minimum kaç RAM gerekir?

Coolify'ın kendisi 1-2 GB RAM ile çalışabilir ama üzerine deploy edeceğiniz uygulamaların build ve çalışma zamanı ihtiyaçları eklenir. Gerçekçi bir başlangıç için en az 4 GB RAM'li bir VDS öneriyoruz; birden fazla servis ve veritabanı çalıştıracaksanız 8 GB ve üzeri daha rahat bir deneyim sağlar.

Coolify ile aynı sunucuda birden fazla proje çalıştırabilir miyim?

Evet, Coolify'ın temel tasarım amacı budur. Her proje ayrı container'larda izole çalışır, kendi domain ve ortam değişkenlerine sahip olur. Sınır, sunucunuzun toplam kaynak kapasitesidir; bir projenin aşırı kaynak tüketmesi diğerlerini etkileyebileceğinden container bazlı kaynak limitleri tanımlamanız önerilir.

Coolify panelini kapatıp uygulamalarım çalışmaya devam eder mi?

Evet. Coolify panel arayüzü sadece yönetim katmanıdır; deploy edilmiş uygulamalarınız kendi container'larında bağımsız çalışır. Panel container'ı geçici olarak durursa (örneğin güncelleme sırasında) çalışan uygulamalarınız etkilenmez, sadece yönetim erişiminiz o süre boyunca kesilir.

Mevcut bir Docker Compose projemi doğrudan Coolify'a taşıyabilir miyim?

Genellikle evet. Coolify, standart bir docker-compose.yml dosyasını "Docker Compose" kaynak tipi olarak kabul eder. Ortam değişkenlerini ve volume tanımlarını panel üzerinden yeniden düzenlemeniz, ayrıca dış port yönlendirmelerini Coolify'ın proxy mantığına uygun hâle getirmeniz gerekebilir.

Coolify ile deploy ettiğim uygulamalar için SSL sertifikası ayrıca satın almam gerekir mi?

Hayır. Coolify, bağladığınız her domain için Let's Encrypt üzerinden otomatik ve ücretsiz SSL sertifikası talep eder ve yeniler. Manuel sertifika yükleme veya yenileme takibi yapmanız gerekmez.

Coolify kurulu bir VDS'i başka bir sunucuya taşımam gerekirse ne yapmalıyım?

Coolify'ın kendi verisini (bağlı kaynaklar, ortam değişkenleri, ayarlar) ve her uygulamanın veritabanı volume'lerini yedekleyip yeni sunucuda Coolify kurulumu üzerinden geri yüklemeniz gerekir. Bu nedenle düzenli, sunucu dışına alınan yedekler yalnızca felaket senaryoları için değil, planlı taşıma işlemleri için de önemlidir.

Coolify'ı üretimde kullanmak güvenli mi, yoksa sadece test/geliştirme ortamı için mi uygundur?

Coolify aktif geliştirilen ve üretimde yaygın kullanılan bir proje. Ancak her self-host araçta olduğu gibi güvenlik sertleştirmesi (SSH sertleştirme, panel erişim kısıtlaması, düzenli yedekleme, güncel tutma) sizin sorumluluğunuzdadır — yönetilen bir platformun aksine, altyapı bakımı size aittir.

Büyükweb Hizmetleri

Coolify gibi self-host PaaS araçlarını sorunsuz çalıştırmak için dedike kaynaklı, kök erişimli bir sunucu altyapısı gerekir:

• VDS Sunucu — Coolify kurulumu, Docker build süreçleri ve çoklu servis deploy'ları için tam kaynak garantili sanal özel sunucu paketleri

Kurulum veya yapılandırma sırasında destek almak isterseniz 0850 302 60 70 numaralı satış öncesi destek numaramızdan bize ulaşabilir veya iletişim sayfası üzerinden mesaj bırakabilirsiniz.