Coolify kurulumu ve ilk uygulamayı yayına alma

Coolify ile uygulama yayınlamayı bir panelden yönetebilirsiniz. Ancak panelin kurulması, uygulamanızın verilerinin otomatik olarak yedeklendiği anlamına gelmez. Bu rehber önce test uygulaması, ardından alan adı ve kalıcı veri kontrolü sırasını izler.

1. Sunucuyu seçin

Örnek ortam temiz Ubuntu 24.04 LTS ve root erişimidir. Resmi başlangıç belgesi 2 çekirdek, 2 GB RAM ve 10 GB boş alanı temel gereksinim olarak veriyor. Aynı sunucuda uygulama derlemek ek bellek ve disk gerektirebilir.

Mevcut bir panel 80/443 portlarını kullanıyorsa aynı sunucuda ikinci proxy kurmak çakışma yaratabilir. Önce portları kontrol edin:

bashsudo ss -lntp

Kurulum ve denemeler için ayrı sunucu kullanmak, mevcut müşterilerinizi etkilemeden öğrenmenizi sağlar.

2. Coolify’ı kurun

bashsudo -i
apt update
apt install -y curl ca-certificates
curl -fsSL https://cdn.coollabs.io/coolify/install.sh -o /root/coolify-install.sh
bash /root/coolify-install.sh

Yükleyici tamamlanınca verdiği bağlantıyı açın; doğrudan panel erişimi 8000 portundadır. İlk yönetici hesabını hemen oluşturun. Hesap oluşturma ekranını internete açık bırakmayın. Kurulum belgesi, yükleyicinin hazırladığı Docker ve veri dizinlerini açıklıyor.

3. Güvenlik duvarı ve alan adı

Self-hosted kurulumda doğrudan erişim için 8000, canlı arayüz ve terminal için gereken ek portlar, SSH ve web trafiği ayrı değerlendirilir. Seçtiğiniz bağlantı biçimine ait listeyi resmi güvenlik duvarı belgesinden uygulayın. Paneli alan adı üzerinden proxy ile kullanırken doğrudan portları herkese açık tutmayın.

Docker port yayınlarının host güvenlik duvarıyla etkileşimini de kontrol edin. Bir UFW kuralının bütün Docker portlarını otomatik koruduğunu varsaymayın; sağlayıcı tarafındaki kuralları da doğrulayın.

4. İlk uygulamayı ekleyin

Bir proje ve test ortamı oluşturun. Önce basit bir Docker imajı veya size ait küçük bir Git deposu seçin. Uygulamanın konteyner içinde dinlediği portu girin; bu değer alan adının HTTPS portuyla aynı olmak zorunda değildir.

Örneğin uygulama 3000’de çalışıyorsa proxy hedefi de 3000 olmalıdır. Süreç konteyner içinde yalnız 127.0.0.1 yerine 0.0.0.0 üzerinde dinlemelidir. Veritabanı parolaları gibi değerleri ortam değişkeni olarak tanımlayın; istemciye derlenen değişkenlere gizli bilgi koymayın.

5. Yayını doğrulayın

Alan adını sunucuya yönlendirin, uygulamanın HTTPS adresini tanımlayın ve Deploy işlemini başlatın. Önce build günlüğünü, ardından çalışan uygulamanın günlüğünü okuyun.

bashcurl -I https://app.example.com

Build başarısız: bağımlılıklar ve build komutu. 502: süreç, port ve dinleme adresi. Veri yeniden yayında kayboluyor: yazılan dizin için kalıcı volume tanımı. Bu sorunlar farklı katmanlardadır; aynı ayarı rastgele değiştirmeyin.

6. Geri dönüş ve yedek

Son çalışan commit veya imaj sürümünü kaydedin. Veritabanı şemasını değiştiren yayınlarda eski uygulamaya dönmek tek başına yeterli olmayabilir. Uygulama verisini ve Coolify’ın kurulum sırlarını ayrı yedekleyin; /data/coolify/source/.env dosyasını güvenli tutun. Docker rehberi ve yedekleme planı bu ayrımı detaylandırır.