Coolify Nedir ve Kendi PaaS Platformunuzu Kurma

Uygulamanızı yayına almak için hâlâ sunucuya SSH ile bağlanıp elle git pull çekiyor, Docker imajı derliyor, Nginx dosyaları düzenliyor ve Let's Encrypt sertifikasını cron ile yeniliyorsanız çok değerli zamanınızı tekrar eden işlere harcıyorsunuz demektir. Heroku, Vercel ya da Netlify gibi platformlar bu işi "git push yap, gerisini biz halledelim" kolaylığına indirger; ancak faturalar büyüdükçe, veriler başkasının sunucusunda durdukça ve özelleştirme sınırlarına çarpıldıkça birçok ekip kendi altyapısına geri dönmek ister. İşte tam bu noktada Coolify devreye girer.

Coolify, kendi sunucunuza kurduğunuz açık kaynaklı bir PaaS (Platform as a Service) yönetim panelidir. Kısaca "kendi Heroku'nuzu kurmak" diye özetlenebilir. Bir GitHub deposunu bağlarsınız, Coolify her push'ta uygulamayı otomatik derler, Docker konteyneri olarak çalıştırır, alan adını yönlendirir ve ücretsiz SSL sertifikasını kendisi alıp yeniler. Tüm bunları tek bir sunucu üzerinden, aylık lisans ücreti olmadan yaparsınız. Bu rehberde Coolify'ın ne işe yaradığını, bir VPS üzerine nasıl kurulduğunu, Git tabanlı otomatik dağıtımın nasıl çalıştığını, veritabanı ve servislerin nasıl ayağa kaldırıldığını, otomatik SSL'in perde arkasını ve Coolify ile Portainer arasındaki temel farkı kıdemli bir sistem yöneticisinin bakış açısıyla adım adım anlatacağım.

Coolify Nedir ve Neden Tercih Edilir#

Coolify'ı en yalın haliyle bir "dağıtım orkestratörü" olarak düşünebilirsiniz. Arka planda Docker'ı kullanır, ama sizi Docker komutlarının, docker-compose dosyalarının ve ters proxy ayarlarının karmaşasından soyutlar. Panele girer, "yeni uygulama" dersiniz, kaynak deponuzu seçersiniz ve dakikalar içinde uygulamanız canlıda çalışır. Bu yüzden Docker'a aşina olmayan geliştiriciler bile Coolify ile çok hızlı yol alır; buna karşılık işin altındaki mantığı merak edenler için Docker'ın temellerini anlatan yazımıza göz atmanızı öneririm, çünkü Coolify'ın neyi otomatikleştirdiğini görmek işleri daha anlaşılır kılar.

Coolify'ın popülerliğinin ardındaki en büyük sebep maliyet ve kontrol dengesidir. Heroku'nun ücretsiz katmanını kaldırmasından sonra küçük projeler bile aylık onlarca dolar ödemeye başladı. Coolify'da ise ödediğiniz tek şey kendi sunucunuzun kira bedelidir; tek bir orta seviye VPS üzerinde onlarca küçük uygulamayı, veritabanını ve zamanlanmış görevi rahatlıkla barındırabilirsiniz. Verileriniz sizin diskinizde durur, KVKK ve veri egemenliği açısından tam denetim sizdedir, üstelik istediğiniz an sunucuyu yedekleyip taşıyabilirsiniz. Açık kaynak olması da kilitlenme (vendor lock-in) riskini büyük ölçüde ortadan kaldırır.

Coolify şu tür yükleri barındırmak için biçilmiş kaftandır: Node.js, PHP/Laravel, Python/Django, Go, Rust, Ruby on Rails ve statik ön yüz uygulamaları (Next.js, Nuxt, Astro, Vite). Ayrıca hazır Docker imajlarını, docker-compose yığınlarını ve WordPress gibi popüler uygulamaları da tek tıkla kurabilirsiniz. Yani hem kendi kodunuzu deploy ettiğiniz bir PaaS hem de hazır servisleri kurduğunuz bir uygulama mağazası gibi çalışır.

Coolify'ın Öne Çıkan Özellikleri#

Coolify'ı yalnızca "web arayüzlü Docker" olarak görmek eksik olur; onu bir PaaS yapan asıl şey uçtan uca otomasyon zinciridir. Aşağıdaki tablo, elle yönetilen bir sunucu ile Coolify arasındaki iş yükü farkını netleştiriyor.

Bunlara ek olarak Coolify, her dağıtımın canlı build loglarını panelde gösterir, uygulama başına CPU/RAM tüketimini izler, webhook ile Discord veya Slack'e bildirim gönderir ve otomatik veritabanı yedeklerini S3 uyumlu bir depoya atabilir. Preview deployment (önizleme dağıtımı) özelliği sayesinde açtığınız her pull request için ayrı bir geçici URL oluşturulur; böylece kodu birleştirmeden önce müşteri veya ekip arkadaşınız değişikliği canlı görebilir. Bu, ajanslar ve çok geliştiricili ekipler için gerçekten değerli bir kolaylıktır.

Coolify Kurulumu VPS Üzerinde#

Coolify'ı kurmak için temiz bir Linux sunucusu yeterlidir. Önerilen dağıtım güncel bir Ubuntu 22.04 veya 24.04 LTS, Debian 12 ya da benzeridir. Kaynak açısından başlangıç için 2 vCPU ve 4 GB RAM makul bir alt sınırdır; ciddi sayıda uygulama barındıracaksanız 4 vCPU ve 8 GB RAM daha rahat ettirir. Bu iş için elinizin altında sabit IP'li, root erişimli bir makine olmalı; kendi projelerimde genelde bir VDS sunucu ya da yeterli kaynağa sahip bir sanal sunucu tercih ediyorum, çünkü Coolify Docker'ı doğrudan kontrol ettiği için kernel erişimi olan bir ortamda çok daha rahat çalışır.

Kurulum tek satırlık resmi betikle yapılır. Sunucuya root olarak bağlandıktan sonra betiği çalıştırmanız yeterli; betik Docker'ı, gerekli bağımlılıkları ve Coolify'ın kendisini otomatik olarak kurar:

# Sunucuya root olarak SSH ile bağlanın
ssh root@sunucu-ip-adresiniz

# Sistemi güncelleyin (iyi bir alışkanlık)
apt update && apt upgrade -y

# Coolify'ı resmi kurulum betiğiyle kurun
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash

Betik tamamlandığında Coolify paneline http://sunucu-ip:8000 adresinden erişebilirsiniz. İlk açılışta bir yönetici hesabı oluşturmanızı ister; bu ilk kaydı hemen yapın, çünkü panel açık IP üzerinde çalışır ve ilk kaydı yapan kişi sahibi olur. Panele girdikten sonra yapılacak ilk iş bir alan adı tanımlamak ve güvenlik duvarını sıkılaştırmaktır. Coolify'ın kendi arayüzünü de bir alan adı arkasına alıp SSL ile koruyabilirsiniz. Bir alan adınız yoksa alan adı sayfamızdan hızlıca kayıt edebilir, DNS A kaydını sunucunuzun IP'sine yönlendirebilirsiniz.

Güvenlik tarafında birkaç temel önlemi ihmal etmeyin. Sunucunun güvenlik duvarında yalnızca gerekli portları açık tutun ve SSH'ı anahtar tabanlı erişimle sınırlayın:

# UFW güvenlik duvarını yapılandırın
ufw allow 22/tcp     # SSH
ufw allow 80/tcp     # HTTP (SSL yönlendirmesi için)
ufw allow 443/tcp    # HTTPS
ufw allow 8000/tcp   # Coolify paneli (sonradan domain arkasına alınca kapatabilirsiniz)
ufw enable

Panelin kendisini bir alt alan adına (örneğin panel.siteniz.com) taşıyıp SSL ile koruduktan sonra 8000 portunu dışarıya kapatmanız en temiz yaklaşımdır. Üretim ortamı için sunucu sertleştirme, düzenli güncelleme ve yedekleme süreçlerini kurumsal ölçekte yönetmek isterseniz sunucu yönetimi hizmetimiz tüm bu operasyonel yükü sizin yerinize üstlenir.

Kaynak Bağlama Git ve Docker Registry#

Coolify'ın kalbi "kaynak" (source) kavramıdır. Bir kaynak, uygulamanızın kodunun geldiği yerdir; bu bir Git deposu ya da bir Docker imaj deposu olabilir. En yaygın senaryo GitHub'ı bağlamaktır. Coolify iki yöntem sunar: kişisel erişim tokenı (PAT) ile hızlı bağlantı ya da GitHub App kurarak daha güvenli ve granüler yetkilendirme. Ciddi projeler için GitHub App yöntemini öneririm, çünkü Coolify böylece yalnızca seçtiğiniz depolara erişir ve webhook'ları otomatik kurar.

Bağlantı kurulduktan sonra Coolify, her git push işleminde tetiklenecek bir webhook oluşturur. GitLab, Gitea ve Bitbucket de benzer şekilde desteklenir; hatta kendi kurduğunuz özel Git sunucularını da SSH anahtarıyla ekleyebilirsiniz. Özel (private) bir Docker registry kullanıyorsanız, önceden derlenmiş imajları çekmek için registry kimlik bilgilerinizi de bir kaynak olarak tanımlarsınız:

# Örnek: özel bir registry'den imaj çekme senaryosu
source: docker-registry
registry: registry.siteniz.com
image: uygulamam/api
tag: latest
auth:
  username: deploy-kullanicisi
  # şifre panelde şifreli saklanır, .env dışına çıkmaz

Kaynak bağlama aşamasında dikkat etmeniz gereken en önemli nokta yetki kapsamıdır. Coolify'a verdiğiniz token yalnızca ihtiyaç duyduğu depolara erişmeli; "tüm depolara tam yetki" vermek yerine dağıtacağınız projeleri tek tek seçin. Bu, olası bir güvenlik ihlalinde zararı sınırlar. Aynı prensip, uygulamaların birbirine değmesini engelleyen konteyner izolasyonu için de geçerlidir; Coolify her uygulamayı kendi ağında ve konteynerinde çalıştırır.

İlk Uygulamanızı Dağıtma Git Tabanlı Deploy#

Kaynak hazır olduğunda ilk dağıtımı yapmak şaşırtıcı derecede kolaydır. Panelde bir "proje" oluşturur, içine "yeni kaynak/uygulama" eklersiniz, bağladığınız GitHub deposunu ve dallanmayı (örneğin main) seçersiniz. Coolify, deponuzu analiz ederek build yöntemini genellikle otomatik algılar: bir Dockerfile varsa onu kullanır, yoksa Nixpacks veya buildpack ile dilinize uygun bir imaj üretmeye çalışır. Node.js için package.json, PHP için composer.json gibi işaretlerden proje tipini çıkarır.

Dağıtım tipini seçtikten sonra ortam değişkenlerinizi panele girersiniz. Bu, elle sunucuda .env düzenlemeye göre çok daha güvenli bir yöntemdir; değerler şifreli saklanır ve loglara sızmaz. Örnek bir yapılandırma şöyle görünür:

# Coolify panelinden girilen ortam değişkenleri
NODE_ENV=production
PORT=3000
DATABASE_URL=postgres://app:sifre@db:5432/uygulama
REDIS_URL=redis://cache:6379
APP_URL=https://uygulamam.siteniz.com

Bir Dockerfile kullanıyorsanız Coolify bu dosyayı olduğu gibi derler. Aşağıdaki gibi basit bir çok aşamalı (multi-stage) Dockerfile, hem hızlı build hem de küçük imaj boyutu sağlar:

# build aşaması
FROM node:20-alpine AS build
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

# çalışma aşaması
FROM node:20-alpine
WORKDIR /app
COPY --from=build /app/dist ./dist
COPY --from=build /app/node_modules ./node_modules
EXPOSE 3000
CMD ["node", "dist/server.js"]

"Deploy" butonuna bastığınızda Coolify webhook'u devreye alır, kodu çeker, imajı derler ve konteyneri ayağa kaldırır. Tüm bu süreci panelde canlı logdan izlersiniz. Bundan sonrası tamamen otomatiktir: main dalına her push yaptığınızda Coolify yeni bir dağıtım başlatır. Bir şey ters giderse önceki başarılı dağıtıma tek tıkla geri dönebilir (rollback), böylece hatalı bir sürüm dakikalarca yayında kalmaz. Bu otomasyon zinciri, WordPress bakım veya özel yazılım projelerinizde canlıya alma stresini gözle görülür biçimde azaltır.

Veritabanı ve Servis Kurulumu#

Modern bir uygulama nadiren tek başınadır; genellikle yanında bir veritabanı, bir önbellek ve belki bir kuyruk servisi ister. Coolify bu ihtiyaçları "servisler" başlığı altında tek tıkla karşılar. PostgreSQL, MySQL, MariaDB, MongoDB, Redis, KeyDB, Clickhouse ve daha fazlası hazır şablon olarak gelir. Bir veritabanı eklediğinizde Coolify konteyneri oluşturur, sürekli bir disk (persistent volume) bağlar ve bağlantı bilgilerini panelde gösterir; siz de bu bilgileri uygulamanızın ortam değişkenlerine yapıştırırsınız.

Kritik nokta veritabanı ile uygulamanın aynı iç ağda konuşmasıdır. Coolify, aynı proje içindeki servisleri özel bir Docker ağına yerleştirir; böylece veritabanı portunu dışarıya açmadan, yalnızca konteyner adı üzerinden (örneğin db:5432) güvenli iletişim kurulur. Veritabanını internete kapalı tutmak, hem güvenlik hem de saldırı yüzeyi açısından altın kuraldır. Bağlantıyı doğrulamak için basit bir SQL denemesi yeterlidir:

-- Uygulama konteynerinden veritabanına bağlanıp doğrulama
CREATE TABLE ping (id serial PRIMARY KEY, checked_at timestamptz DEFAULT now());
INSERT INTO ping DEFAULT VALUES;
SELECT * FROM ping ORDER BY id DESC LIMIT 1;

Coolify'ın veritabanı tarafındaki en sevdiğim özelliği otomatik yedeklemedir. Her veritabanı için zamanlanmış yedekler tanımlayabilir, bunları yerel diske ya da S3 uyumlu bir depoya gönderebilirsiniz. Yine de tek bir sunucuya güvenmek yerine yedekleri farklı bir konumda tutmayı öneririm; bu konuda kurumsal ölçekli, sunucu dışı bir çözüm arıyorsanız yedekleme hizmetimiz düzenli ve otomatik yedeklerinizi güvence altına alır. Hazır uygulama ihtiyaçlarınız (n8n, Ghost, Nextcloud gibi) için ise Coolify şablonlarına ek olarak App Center üzerinden tek tıkla kuruluma göz atabilirsiniz.

Otomatik SSL ve Alan Adı Yönetimi#

Coolify'ın en çok zaman kazandıran özelliği hiç kuşkusuz otomatik SSL'dir. Arka planda bir ters proxy (Traefik) çalışır ve tanımladığınız her alan adı için Let's Encrypt'ten ücretsiz sertifikayı otomatik alır, HTTP'yi HTTPS'e yönlendirir ve sertifika süresi dolmadan sessizce yeniler. Yani Certbot kurmak, cron yazmak ya da Nginx sanal sunucu blokları düzenlemekle uğraşmazsınız; uygulamanın ayarlarına alan adını yazmanız yeterlidir.

İşleyiş şöyledir: önce alan adınızın DNS A kaydını sunucunuzun IP'sine yönlendirirsiniz, sonra Coolify panelinde uygulamaya bu alan adını atarsınız. DNS yayılması tamamlandığında Coolify sertifika doğrulamasını yapar ve site birkaç dakika içinde HTTPS ile açılır. DNS tarafındaki tipik bir yapılandırma şöyledir:

; siteniz.com DNS bölgesi
uygulamam    IN  A     203.0.113.10
api          IN  A     203.0.113.10
www          IN  CNAME uygulamam.siteniz.com.

Coolify wildcard (joker) sertifikaları ve birden fazla alan adını tek uygulamaya bağlamayı da destekler; preview deployment özelliğiyle her PR için otomatik alt alan adı ve sertifika üretmesi de bu altyapı sayesindedir. Yine de canlıya çıkan projelerde SSL'in ötesine geçmenizi öneririm: uygulama katmanı saldırılarına karşı bir WAF ve hacim tabanlı saldırılara karşı DDoS koruma devreye alarak güvenliği katmanlı hale getirin. Kurumsal bir projeyi taşırken sertifika, e-posta ve DNS ayarlarının doğru aktarımı için site taşıma hizmetimiz de süreci sorunsuz kılar. Sertifika türleri ve doğrulama yöntemleri hakkında daha derin bilgi için SSL sayfamıza bakabilirsiniz.

Coolify ve Portainer Farkı#

Coolify ile Portainer sık sık karıştırılır, çünkü ikisi de Docker üzerine kurulu, web arayüzlü yönetim araçlarıdır. Ancak felsefeleri temelden farklıdır. Portainer bir konteyner yönetim panelidir; var olan Docker ve Kubernetes ortamlarınızı görselleştirir, konteynerleri başlatıp durdurur, imajları ve ağları yönetir. Yani Portainer size Docker'ın kontrol düğmelerini verir. Coolify ise bir PaaS'tır; hedefi konteynerleri yönetmek değil, kaynak kodunuzdan otomatik olarak çalışan bir uygulamaya giden tüm zinciri (build, deploy, proxy, SSL, veritabanı) sizin yerinize kurmaktır.

Aşağıdaki tablo iki aracın konumlanmasını netleştiriyor:

Pratikte seçim iş akışınıza bağlıdır. Amacınız "kodu yazdım, git push ile yayına alayım" ise Coolify sizi hedefe en kısa yoldan götürür. Amacınız "elimde çeşitli konteynerler var, bunları tek panelden gözlemleyip yönetmek istiyorum" ise Portainer daha uygundur. İkisi birlikte de kullanılabilir; bazı ekipler dağıtımı Coolify'a bırakırken, sunucudaki tüm konteyner ekosistemini gözlemlemek için Portainer'ı yan yana çalıştırır. Karar verirken kendi ekibinizin becerisini ve projenin ölçeğini göz önünde bulundurun.

Sıkça Sorulan Sorular#

Coolify tamamen ücretsiz mi?#

Evet, Coolify'ın kendi kendine barındırılan (self-hosted) sürümü açık kaynaklıdır ve tamamen ücretsizdir. Ödediğiniz tek şey Coolify'ı çalıştırdığınız sunucunun kira bedelidir. Coolify ekibinin ayrıca yönetimli bir bulut sürümü de vardır; onu kendi sunucunuz olmadan kullanmak isteyenler için abonelik ücretlidir, ama çoğu kullanıcı için kendi VPS'inize kurmak hem daha ekonomik hem de daha esnektir.

Coolify için hangi sunucu kaynakları gerekir?#

Başlangıç ve küçük projeler için 2 vCPU ile 4 GB RAM makul bir alt sınırdır. Coolify'ın kendisi görece hafiftir; asıl kaynağı çalıştırdığınız uygulamalar ve veritabanları tüketir. Birkaç uygulama, bir PostgreSQL ve bir Redis'i rahatça barındırmak için 4 GB RAM yeterli olur. Onlarca servis çalıştıracaksanız 8 GB RAM ve 4 vCPU'lu bir sunucuya geçmek daha rahat ettirir; disk olarak da SSD tercih edin.

Coolify kullanmak için Docker bilmem gerekir mi?#

Zorunlu değildir. Coolify Docker'ı sizin yerinize yönettiği için basit senaryolarda hiç Docker komutu yazmadan uygulamanızı yayına alabilirsiniz. Ancak temel Docker kavramlarını (imaj, konteyner, volume, ağ) bilmek sorun çözerken ve gelişmiş yapılandırmalar yaparken çok işinize yarar. Konuya yabancıysanız temel bir Docker rehberiyle başlamak, Coolify'ın perde arkasında ne yaptığını anlamanızı kolaylaştırır.

Mevcut bir Heroku projesini Coolify'a taşıyabilir miyim?#

Çoğu durumda evet. Heroku uygulamaları standart bir yapı kullandığı için Coolify bunları genellikle sorunsuz derler. Yapmanız gereken kod deposunu Coolify'a bağlamak, Heroku'daki ortam değişkenlerini panele taşımak ve veritabanınızı yeni sunucuya aktarmaktır. PostgreSQL gibi veritabanları için bir dump alıp yeni Coolify veritabanına yüklemek yeterlidir. Alan adı ve SSL tarafını da Coolify otomatik hallettiği için geçiş genelde birkaç saat içinde tamamlanır.

Coolify üretim ortamı için yeterince güvenilir mi?#

Coolify olgunlaşmış ve geniş bir topluluğa sahip bir projedir; birçok ekip onu üretimde kullanır. Yine de tek bir sunucuya bağımlı olmanın riskini unutmayın: sunucu düşerse tüm uygulamalarınız etkilenir. Bunu düzenli otomatik yedekler alarak, yedekleri sunucu dışında saklayarak ve kritik projelerde birden fazla sunucu ile yatay ölçekleme planlayarak azaltabilirsiniz. Güvenlik güncellemelerini takip etmek, paneli alan adı arkasında SSL ile korumak ve güvenlik duvarını sıkı tutmak da üretim güvenilirliği için şarttır.

Kapanış#

Coolify, kendi altyapınız üzerinde Heroku benzeri bir dağıtım deneyimi kurmanın en pratik yollarından biridir. Git tabanlı otomatik dağıtımı, tek tıkla veritabanı ve servis kurulumu, otomatik SSL'i ve şeffaf log takibiyle geliştiriciyi tekrar eden operasyonel işlerden kurtarır; üstelik verileriniz kendi sunucunuzda kalır ve aylık lisans faturasıyla uğraşmazsınız. Portainer'a kıyasla amacının konteyner yönetmek değil, uçtan uca uygulama dağıtmak olduğunu aklınızda tutarsanız hangi aracı ne zaman kullanacağınızı da netleştirmiş olursunuz.

Coolify'ı çalıştıracağınız güçlü ve kararlı bir altyapıya ihtiyacınız varsa, root erişimli ve yüksek performanslı VDS ile sanal sunucu seçeneklerimize, yönetim yükünü bize devretmek isterseniz sunucu yönetimi hizmetimize göz atın. Alan adınızı buradan alıp yedekleme, SSL ve WAF çözümlerimizle projenizi baştan sona güvence altına alabilirsiniz. Kendi PaaS platformunuzu kurmanın tam zamanı; Clou.TR altyapısıyla ilk uygulamanızı bugün canlıya alabilirsiniz.