Coolify Kurulumu: Kendi VPS'inizde Heroku ve Vercel Benzeri PaaS

Coolify nedir, neyi yönetir?

Resmî belgeler Coolify'ı uygulamaları, veritabanlarını ve servisleri sizin kontrolünüzdeki sunucularda dağıtıp yöneten açık kaynaklı bir platform olarak tanımlar. Coolify bir "kontrol düzlemi"dir: bağlı her sunucuya SSH ile bağlanır, sunucuyu Docker iş yüklerine hazırlar ve derleme, dağıtım, alan adı, HTTPS ve sağlık kontrolü gibi işleri koordine eder. Lisansı Apache 2.0'dır. Kendi sunucunuza kurabileceğiniz gibi Coolify Cloud adlı yönetilen bir seçenek de vardır; bu rehber kendi sunucunuza kurulumu anlatır.

Tek bir Coolify örneği birden fazla sunucuyu yönetebilir. Belgelere göre dağıtılan kaynaklar standart Docker konteynerleri olduğu için Coolify kapansa bile çalışan uygulamalar çalışmaya devam eder; yalnızca otomasyonu ve panel kontrolünü kaybedersiniz. Docker'ı elle yönetmeyi tercih ediyorsanız Docker ile uygulama deploy ve Portainer yazılarımız daha uygun bir başlangıç olabilir.

Gereksinimler

"Start with Self-hosted" belgesindeki asgari donanım gereksinimleri şunlardır:

Belgeler Coolify'ın daha küçük sunucularda da çalışabileceğini ama bunun önerilmediğini, derlemeler ile Coolify'ı aynı sunucuda çalıştırıyorsanız kaynak kullanımını izlemeniz gerektiğini, aksi halde sunucunun yanıt vermez hale gelebileceğini belirtir. Desteklenen dağıtımlar arasında Debian ve Ubuntu bulunur; Ubuntu'da 20.04, 22.04 veya 24.04 gibi bir LTS sürümü kullanmanız önerilir. Ayrıca belgeler Coolify'ı çakışmaları önlemek için temiz (yeni kurulmuş) bir sunucuya kurmanızı tavsiye eder.

Kullandığı portlar ve güvenlik duvarı

Firewall belgesine göre Coolify'ın kurulu olduğu sunucuda şu portlar kullanılır:

Coolify'ın uzaktan yönettiği ek sunucularda ise yalnızca 22, 80 ve 443 gerekir; belgeler SSH kuralını mümkünse Coolify sunucusunun IP adresiyle sınırlamanızı önerir.

UFW'yi yine de ana sunucu güvenlik duvarı olarak kullanmak isterseniz temel kurallar için UFW rehberimize bakın; ancak Docker'ın yayınladığı portları UFW'nin engellemeyeceğini unutmayın. Değişiklik yaparken mevcut SSH oturumunuzu kapatmayın ve sonucu başka bir bağlantıdan test edin.

Adım 1: Resmî kurulum betiği

Coolify ekibinin önerdiği yöntem otomatik kurulum betiğidir ve kök kullanıcı erişimi gerektirir. Sunucuya root veya sudo yetkili bir kullanıcıyla bağlanın ve şu komutu çalıştırın:

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

Belgelere göre betik şunları yapar:

• Gerekli paketleri kurar (curl, wget, git, jq, openssl),
• Dağıtımınız destekleniyorsa Docker Engine'i kurar,
• Docker ayarlarını (günlükleme, daemon) yapılandırır,
• /data/coolify altında Coolify dizinlerini oluşturur,
• Sunucu yönetimi için SSH anahtarlarını yapılandırır,
• Coolify'ı kurar ve başlatır.

Docker'ı zaten kurduysanız veya kök olmayan bir kullanıcıyla kurmak istiyorsanız belgelerde adım adım "Manual installation" yöntemi de vardır; bu yöntem Docker Engine 24 veya üstünü gerektirir.

Adım 2: Yönetici hesabını hemen oluşturun

Kurulum bittiğinde terminalde bir "Congratulations!" mesajı ve panel bağlantısı görürsünüz. Tarayıcıda http://SUNUCU_IP:8000 adresini açın ve yönetici hesabını oluşturun.

env ROOT_USERNAME=YONETICI_ADI \
ROOT_USER_EMAIL=eposta@ornekalan.com \
ROOT_USER_PASSWORD='GUCLU_BIR_SIFRE' \
bash -c 'curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash'

Belgelere göre parola en az 8 karakter olmalı ve büyük harf, küçük harf, rakam ve özel karakter içermelidir. Root olarak oturum açmadıysanız komutun başına sudo -E eklenir. Güçlü parola için güçlü şifre rehberimize bakabilirsiniz.

Adım 3: Kurulum sırlarını yedekleyin

/data/coolify/source/.env dosyası, Coolify veritabanındaki değerleri şifrelemek için kullanılan APP_KEY gibi kurulum sırlarını içerir. Belgelere göre veritabanı yedeği bu dosyayı içermez ve eşleşen anahtar olmadan geri yüklenen veritabanındaki şifreli kimlik bilgileri okunamaz. Anahtarı görüntüleyip sunucu dışında, örneğin bir parola yöneticisinde saklayın:

sudo grep '^APP_KEY=' /data/coolify/source/.env

Kendi parola yöneticinizi barındırmak isterseniz Vaultwarden kurulumu yazımıza bakabilirsiniz.

Adım 4: Paneli alan adına ve HTTPS'e taşıyın

Panelin şifresiz HTTP üzerinden 8000 portunda kalması, oturum bilgilerinizin ağda açık dolaşması demektir. Coolify'ın kendi proxy'si (varsayılan olarak Traefik) alan adları için HTTPS sertifikalarını otomatik yönetir. Bu yüzden Nginx kurmak yerine projenin belgelediği yolu izleyin:

• Panel için bir alt alan adı (ör. coolify.ornekalan.com) seçin ve DNS'te sunucu IP'nize yönlenen bir A kaydı oluşturun. DNS yayılması için TTL rehberimize bakabilirsiniz.
• Panelde Settings sayfasındaki General bölümünde URL alanına https:// ile başlayan tam adresi girip kaydedin. Belgelere göre yol tabanlı adresler (ornekalan.com/coolify) desteklenmez ve bir uygulamanın alan adını panel için tekrar kullanmamalısınız.
• Panelin, gerçek zamanlı güncellemelerin ve web terminalinin alan adı üzerinden çalıştığını doğrulayın.
• Ancak bundan sonra 8000, 6001 ve 6002 portlarını dışarıya kapatın. Firewall belgesine göre panel alan adı üzerinden çalıştıktan sonra bu üç port kapatılabilir; trafik 80 ve 443 üzerinden proxy'ye gider.

Bu portları kapatmanın bir yolu sağlayıcı güvenlik duvarıdır. Diğer yol, belgelerde anlatılan Compose override dosyasıdır. Coolify güncellemeleri ana Compose dosyalarını değiştirir ama /data/coolify/source/docker-compose.custom.yml dosyası otomatik yüklenir ve güncellemede silinmez. Portları yalnızca sunucunun kendisine açmak için belgedeki örnek:

services:
  coolify:
    ports: !override
      - "127.0.0.1:${APP_PORT:-8000}:8080"
      - "127.0.0.1:${SOKETI_PORT:-6001}:6001"
      - "127.0.0.1:6002:6002"

Dosyayı kaydettikten sonra belgelerdeki gibi doğrulayın ve otomatik kurulum yaptıysanız belgelerin önerdiği gibi değişikliği uygulayın:

cd /data/coolify/source
docker compose --env-file .env \
  -f docker-compose.yml \
  -f docker-compose.prod.yml \
  -f docker-compose.custom.yml \
  config

Adım 5: Paneli sertleştirin

Security Model belgesi Coolify'ı "ayrıcalıklı bir kontrol düzlemi" olarak tanımlar: SSH özel anahtarlarını saklar ve bunlarla bağlı sunucularda komut çalıştırır. Yeterli yönetici erişimi ele geçiren biri aynı yolları kullanabilir. Bu yüzden panel erişimini sunucuya doğrudan kök erişimi gibi korumalısınız. Belgelerdeki üretim ortamı temel listesinden özetle:

• Paneli HTTPS üzerinden sunun ve mümkünse kimlerin erişebileceğini kısıtlayın.
• Registration ayarını "Registration disabled" konumunda tutun; böylece yalnızca yöneticiler hesap oluşturabilir.
• Yetkili her hesapta iki adımlı doğrulamayı açın ve kurtarma kodlarını güvenli saklayın.
• API erişimini yalnızca gerektiğinde açın; açtıysanız Settings > Advanced altında izinli IP adreslerini sınırlayın ve her entegrasyona en az yetkili, süreli ayrı token verin.
• İşletim sistemini ve Docker'ı güncel tutun, SSH'yi sertleştirin ve yalnızca gerekli portları açın. Bunun için VPS güvenlik sertleştirme ve Fail2ban yazılarımıza bakın.
• Veritabanlarını ve iç servisleri Docker ağlarında tutun; belgeler bir host portu yayınlamanın proxy'den bağımsız doğrudan bir ağ yolu açtığını hatırlatır.

Güncelleme

Coolify'ı panelden Settings > Updates bölümünden güncelleyebilir veya otomatik güncellemeyi açabilirsiniz. Belgeler güncellemeden önce örnek yedeği almanızı, Coolify sürüm notları sayfasını okumanızı ve devam eden dağıtım olmadığından emin olmanızı önerir; güncelleme sırasında çalışan dağıtımlar başarısız olabilir. Terminalden güncellemek için belgeler upgrade.sh betiğini ve sürüm numarasını açıkça belirtmeyi önerir:

curl -fsSL https://cdn.coollabs.io/coolify/upgrade.sh | bash -s SURUM_NUMARASI

SURUM_NUMARASI yerine başında v olmadan kurmak istediğiniz sürümü yazın. Belgelere göre sürüm verilmezse betik .env dosyasına COOLIFY_VERSION=latest yazar ve güncelleme kontrolleri düzgün çalışmaz.

Yedekleme

Coolify örnek yedeği projeleri, kaynakları, ayarları ve dağıtım geçmişini içerir; uygulamalarınızın, veritabanlarınızın veya volume'lerinizin içindeki veriyi içermez. Panelde Settings > Backup altında günlük zamanlanmış yedek ve isteğe bağlı S3 kopyası ayarlanabilir. Terminalden elle yedek almak için belgelerdeki komut:

mkdir -p /data/backups
docker exec coolify-db \
  pg_dump --format=custom --no-acl --no-owner \
  --username=coolify coolify \
  > /data/backups/coolify-db-manual-backup.dmp

Yedek dosyasını ve APP_KEY'i sunucu dışında saklayın. Uygulama ve veritabanı verileriniz için ayrıca yedek planı yapın; strateji için veritabanı yedekleme stratejileri ve rsync ile yedekleme yazılarımıza bakabilirsiniz.

Sık karşılaşılan sorunlar

Sık Sorulan Sorular

Coolify ücretsiz mi?

Evet, kendi sunucunuza kurduğunuz Coolify Apache 2.0 lisanslı açık kaynak yazılımdır. Yönetilen sürüm olan Coolify Cloud ise ayrı bir hizmettir.

Coolify'ı mevcut sitelerimin olduğu sunucuya kurabilir miyim?

Belgeler çakışmaları önlemek için temiz bir sunucu önerir. Coolify'ın proxy'si 80 ve 443 portlarını kullandığı için mevcut bir Nginx veya Apache kurulumuyla çakışır.

Coolify kapanırsa uygulamalarım da kapanır mı?

Belgelere göre hayır. Çalışan kaynaklar standart Docker konteynerleri olduğu için çalışmaya devam eder; Coolify geri gelene kadar yalnızca otomasyon ve panel kontrolü kullanılamaz.

Panel portlarını UFW ile kapatmak yeterli mi?

Hayır. Coolify ve Docker belgelerine göre Docker'ın yayınladığı portlar UFW kurallarını atlayabilir. Sağlayıcı güvenlik duvarı, ufw-docker veya portları 127.0.0.1'e bağlayan Compose override kullanın.

Yazılım ve hizmet adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen projeler veya şirketlerle ortaklık ilişkisi bulunduğu anlamına gelmez.

İlgili içerikler: Uptime Kuma kurulumu · Portainer kurulumu · Gitea ile kendi Git sunucunuz · GitHub Actions ile VPS deploy · Docker ile uygulama deploy · UFW güvenlik duvarı · VPS güvenlik sertleştirme · Reverse proxy nedir