Coolify VDS Sunucularda Nasıl Kurulur? Adım Adım Deployment Rehberi

Son Güncelleme: Eylül 2026

coolify vds kurulumu, kendi uygulamalarınızı, veritabanlarınızı ve servislerinizi modern bir panel üzerinden yönetmek isteyen geliştiriciler için pratik ve güçlü bir çözümdür. Coolify, açık kaynaklı bir PaaS yani Platform as a Service yaklaşımı sunarak Docker tabanlı dağıtımları kolaylaştırır ve VDS sunucular üzerinde uygulama yayınlama sürecini sadeleştirir.

Bu rehberde coolify vds kurulumu için gerekli sunucu hazırlıklarını, güvenlik adımlarını, kurulum komutlarını, domain yönlendirme ayarlarını ve ilk deployment sürecini adım adım öğreneceksiniz. Eğer kurulumla uğraşmadan hazır bir altyapı tercih ediyorsanız Coolify Hosting hizmetini de değerlendirebilirsiniz.

İçindekiler

• Coolify Nedir?
• Coolify VDS Kurulumu İçin Gereksinimler
• VDS Sunucu Hazırlığı
• Coolify Kurulum Adımları
• İlk Yapılandırma ve Panel Ayarları
• Adım Adım Deployment Rehberi
• Güvenlik ve Optimizasyon Önerileri
• Yaygın Hatalar ve Çözümleri
• Sıkça Sorulan Sorular
• Sonuç

Coolify Nedir?

Coolify, geliştiricilerin uygulamalarını kendi sunucuları üzerinde kolayca yayınlamasını sağlayan açık kaynaklı bir deployment ve uygulama yönetim platformudur. Klasik hosting panellerinden farklı olarak Coolify; Node.js, PHP, Laravel, WordPress, statik web siteleri, Docker Compose projeleri, veritabanları ve çeşitli servisleri modern bir arayüz üzerinden yönetmeye odaklanır.

coolify vds kurulumu özellikle Git tabanlı geliştirme akışı kullanan ekipler için büyük kolaylık sağlar. GitHub, GitLab veya benzeri bir kaynak kod deposundan uygulamanızı bağlayabilir, build yani derleme sürecini tanımlayabilir, environment variable yani ortam değişkenlerini ekleyebilir ve tek tıklamayla deployment işlemi başlatabilirsiniz.

Coolify Hangi Sorunu Çözer?

Geleneksel deployment süreçlerinde geliştiriciler genellikle SSH ile sunucuya bağlanır, bağımlılıkları manuel kurar, web sunucusu yapılandırır, SSL sertifikası ekler, servis dosyaları oluşturur ve güncellemeleri komut satırından yönetir. Bu yapı küçük projelerde kabul edilebilir olsa da proje sayısı arttıkça karmaşık hale gelir. Coolify bu noktada, sunucu yönetimi ile uygulama dağıtımı arasındaki operasyonel yükü azaltır.

• Merkezi yönetim: Uygulamalar, veritabanları ve servisler tek panelden takip edilir.
• Docker tabanlı yapı: Uygulamalar izole container yani kapsayıcı ortamlarında çalışır.
• Kolay SSL: Domain bağlama ve HTTPS yapılandırması pratik hale gelir.
• Git entegrasyonu: Kod deposundan otomatik veya manuel deployment yapılabilir.
• Açık kaynak avantajı: Platform üzerinde daha fazla kontrol sahibi olursunuz.

Bu avantajlar sayesinde coolify vds kurulumu, özellikle geliştirici ajansları, SaaS girişimleri, yazılım ekipleri ve çoklu proje yöneten sistem yöneticileri için oldukça verimli bir tercihtir.

Coolify VDS Kurulumu İçin Gereksinimler

Başarılı bir coolify vds kurulumu için öncelikle uygun kaynaklara sahip bir VDS sunucuya ihtiyacınız vardır. Coolify, Docker tabanlı çalıştığı için sunucunun sanallaştırma uyumluluğu, disk performansı, bellek kapasitesi ve ağ kararlılığı önemlidir.

Önerilen Sistem Kaynakları

Desteklenen İşletim Sistemi

Coolify için genellikle Ubuntu veya Debian tabanlı Linux dağıtımları tercih edilir. Bu rehberde örnekler Ubuntu sunucu üzerinden verilecektir. Sunucunun temiz kurulum olması, önceden karmaşık web paneli veya çakışabilecek servisler barındırmaması tavsiye edilir.

• İşletim sistemi: Ubuntu 22.04 LTS veya Ubuntu 24.04 LTS gibi güncel LTS sürümleri tercih edilebilir.
• Root erişimi: Kurulum için root veya sudo yetkisine sahip kullanıcı gerekir.
• Statik IP: Domain yönlendirmesi için sabit IP adresi önerilir.
• Temiz sunucu: Mevcut Nginx, Apache, Docker veya farklı panel kurulumları çakışma yaratabilir.
• DNS yönetimi: Coolify paneli ve uygulamalar için alan adı kayıtlarına erişiminiz olmalıdır.

Hazır ve optimize edilmiş bir altyapıyla başlamak isterseniz Coolify Hosting hizmeti, manuel kurulum adımlarını azaltarak daha hızlı başlangıç yapmanızı sağlar.

VDS Sunucu Hazırlığı

coolify vds kurulumu işlemine başlamadan önce sunucunun temel güvenlik ve sistem güncelleme adımlarının tamamlanması gerekir. Bu aşama, kurulum sonrası karşılaşılabilecek bağlantı, paket uyumsuzluğu ve güvenlik açıklarını azaltır.

SSH ile Sunucuya Bağlanma

İlk olarak sunucunuza SSH üzerinden bağlanın. Terminal veya SSH istemcinizden aşağıdaki komutu kullanabilirsiniz:

ssh root@SUNUCU_IP_ADRESI

Root kullanıcısı yerine sudo yetkili bir kullanıcı kullanıyorsanız komutları sudo ile çalıştırmanız gerekebilir. Güvenlik açısından, kurulum sonrasında root ile doğrudan girişin kapatılması ve anahtar tabanlı SSH kullanılması önerilir.

Sistem Paketlerini Güncelleme

Sunucuya bağlandıktan sonra paket listesini güncelleyin ve mevcut paketleri yükseltin:

apt update && apt upgrade -y

Bu işlem, işletim sistemindeki güvenlik yamalarını ve paket güncellemelerini uygular. Kurulumdan önce sistemi güncel tutmak, Docker ve Coolify bileşenlerinin daha kararlı çalışmasına yardımcı olur.

Gerekli Yardımcı Paketleri Kurma

Temel araçları kurmak için aşağıdaki komutu çalıştırabilirsiniz:

apt install -y curl wget git ufw ca-certificates gnupg lsb-release

• curl: Kurulum betiklerini indirmek ve API çağrıları yapmak için kullanılır.
• git: Kod depoları ile çalışmak için gereklidir.
• ufw: Basit firewall yani güvenlik duvarı yönetimi sağlar.
• ca-certificates: Güvenli bağlantılar için sertifika doğrulamasında kullanılır.

Firewall Portlarını Açma

Coolify ve uygulamalarınızın doğru çalışması için gerekli portları açmanız gerekir. Temel bir yapılandırma için aşağıdaki komutları kullanabilirsiniz:

ufw allow OpenSSH
ufw allow 80/tcp
ufw allow 443/tcp
ufw allow 8000/tcp
ufw enable
ufw status

80 HTTP, 443 HTTPS, 8000 ise ilk Coolify erişimi için kullanılabilir. Panel erişim portu kurulum yöntemine göre değişebileceğinden, kurulum çıktısında belirtilen bilgileri kontrol etmeniz önemlidir.

Coolify Kurulum Adımları

Sunucu hazırlandıktan sonra coolify vds kurulumu için resmi kurulum betiği kullanılabilir. Coolify kurulumu genellikle Docker bileşenlerini, gerekli servisleri ve panel ortamını otomatik olarak yapılandırır. Bu nedenle temiz bir VDS üzerinde kurulum yapmak en sorunsuz yöntemdir.

Kurulum Komutunu Çalıştırma

Sunucunuzda aşağıdaki komutu çalıştırarak Coolify kurulumunu başlatabilirsiniz:

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

Komut çalıştığında kurulum betiği gerekli kontrolleri yapar, Docker altyapısını hazırlar ve Coolify servislerini başlatır. Kurulum süresi sunucu performansına ve ağ bağlantısına göre değişebilir. İşlem tamamlandığında terminal çıktısında panele erişim bilgileri görüntülenir.

Kurulum Sonrası Servis Kontrolü

Kurulum tamamlandıktan sonra Docker container durumlarını kontrol etmek faydalıdır:

docker ps

Bu komut çalışan container yani kapsayıcıları listeler. Coolify bileşenleri listede görünüyorsa temel kurulum başarılı şekilde tamamlanmış demektir. Eğer container görünmüyorsa log kayıtlarını kontrol etmeniz gerekir.

Log Kontrolü

Hata ayıklama için Docker logları önemli bilgiler sağlar. Örnek olarak ilgili container adını öğrendikten sonra şu komutu kullanabilirsiniz:

docker logs CONTAINER_ADI --tail=100

Loglarda bağlantı hatası, port çakışması, disk alanı yetersizliği veya yetki problemi gibi detayları görebilirsiniz. coolify vds kurulumu sırasında en sık görülen sorunların büyük kısmı portların kapalı olması, eski Docker kalıntıları veya düşük sistem kaynaklarından kaynaklanır.

İlk Yapılandırma ve Panel Ayarları

Kurulum tamamlandıktan sonra tarayıcınızdan sunucu IP adresi ve belirtilen port üzerinden Coolify paneline erişebilirsiniz. İlk erişimde yönetici hesabı oluşturmanız ve temel platform ayarlarını tamamlamanız gerekir.

Yönetici Hesabı Oluşturma

Coolify paneli ilk açıldığında sizden bir yönetici hesabı oluşturmanız istenir. Güçlü bir parola belirleyin ve mümkünse parola yöneticisi kullanın. Yönetici hesabı, tüm uygulama, servis, veritabanı ve sunucu kaynaklarını yönetebileceği için bu hesabın güvenliği kritik öneme sahiptir.

• E-posta: Bildirimler ve kullanıcı tanımlamaları için geçerli bir e-posta girin.
• Güçlü parola: Büyük harf, küçük harf, rakam ve sembol içeren uzun parolalar tercih edin.
• Yetki kontrolü: Panel erişimini sadece gerekli kullanıcılarla paylaşın.

Domain ve DNS Ayarları

Coolify panelini IP adresi yerine bir alan adı üzerinden kullanmak daha profesyonel ve güvenlidir. Örneğin panel.ornekdomain.com gibi bir alt alan adı oluşturabilir ve A kaydını VDS sunucunuzun IP adresine yönlendirebilirsiniz.

panel.ornekdomain.com  A  SUNUCU_IP_ADRESI

DNS yönlendirmesi tamamlandıktan sonra Coolify içinde panel domain ayarını yapabilir ve SSL sertifikasını etkinleştirebilirsiniz. SSL etkinleştirildiğinde panel erişimi HTTPS üzerinden güvenli hale gelir.

Sunucu Kaynaklarının Tanımlanması

Coolify, üzerinde çalıştığı lokal sunucuyu kaynak olarak kullanabilir. Daha gelişmiş senaryolarda uzak Docker sunucuları da eklenebilir. Tek VDS kullanıyorsanız genellikle lokal sunucu yeterlidir. Ancak birden fazla VDS ile çalışıyorsanız, projeleri farklı sunuculara dağıtarak kaynak kullanımını dengeleyebilirsiniz.

Kurulum ve yönetim sürecini daha pratik hale getirmek için hazır altyapı tercih eden kullanıcılar Coolify Hosting çözümüyle Coolify tabanlı uygulama yayınlama süreçlerini daha hızlı başlatabilir.

Adım Adım Deployment Rehberi

coolify vds kurulumu tamamlandıktan sonra en önemli aşama uygulama deployment sürecidir. Deployment, geliştirdiğiniz uygulamanın canlı sunucu ortamına hazırlanması, çalıştırılması ve kullanıcıların erişimine açılmasıdır. Coolify bu süreci panel üzerinden yönetmenizi sağlar.

1. Yeni Proje Oluşturma

Coolify paneline giriş yaptıktan sonra yeni bir proje oluşturun. Proje, bir veya birden fazla uygulamayı, veritabanını ve servisi gruplamak için kullanılır. Örneğin bir Laravel uygulaması, MySQL veritabanı ve Redis servisini aynı proje altında yönetebilirsiniz.

• Proje adı: Anlaşılır ve kısa bir isim belirleyin.
• Ortam türü: Production yani canlı ortam veya staging yani test ortamı olarak planlayın.
• Kaynak seçimi: Uygulamanın hangi VDS üzerinde çalışacağını belirleyin.

2. Git Deposu Bağlama

Uygulamanızı Git tabanlı bir depodan yayınlamak için repository yani kod deposu bağlantısı ekleyin. Bağlantı türüne göre erişim anahtarı, token veya OAuth yöntemi kullanılabilir. Kod deposu bağlandıktan sonra branch yani dal seçimi yapılır. Genellikle canlı ortam için main veya master, test ortamı için develop dalı tercih edilir.

3. Build Ayarlarını Yapılandırma

Coolify, uygulama tipine göre otomatik algılama yapabilir. Ancak üretim ortamında build komutlarını açık şekilde belirtmek daha kontrollü bir yaklaşımdır. Örneğin bir Node.js uygulaması için:

npm install
npm run build
npm run start

Laravel tabanlı bir PHP uygulamasında ise örnek deployment süreci şu adımları içerebilir:

composer install --no-dev --optimize-autoloader
php artisan migrate --force
php artisan config:cache
php artisan route:cache
php artisan view:cache

Bu komutlar projenin bağımlılıklarını kurar, veritabanı migration işlemlerini uygular ve cache dosyalarını optimize eder. Komutları projenizin ihtiyaçlarına göre düzenlemeniz gerekir.

4. Ortam Değişkenlerini Tanımlama

Environment variable yani ortam değişkenleri, uygulamanın gizli veya ortama göre değişen ayarlarını saklamak için kullanılır. Veritabanı şifresi, API anahtarı, uygulama anahtarı ve servis adresleri bu alanda tanımlanmalıdır. Örnek değişkenler:

APP_ENV=production
APP_DEBUG=false
APP_URL=https://ornekdomain.com
DB_HOST=mysql
DB_DATABASE=app_db
DB_USERNAME=app_user
DB_PASSWORD=GucluParola

Gizli bilgileri kod deposuna yazmak güvenlik riski oluşturur. Bu nedenle .env benzeri hassas yapılandırmalar Coolify paneli üzerinden güvenli şekilde yönetilmelidir.

5. Domain Bağlama ve SSL Etkinleştirme

Uygulamanız için bir domain veya subdomain belirleyin. DNS tarafında A kaydını VDS IP adresine yönlendirdikten sonra Coolify panelinde ilgili uygulamaya domain ekleyin. Ardından SSL sertifikasını etkinleştirin. Bu sayede ziyaretçiler uygulamanıza HTTPS üzerinden erişir.

6. İlk Deployment İşlemini Başlatma

Tüm ayarlar tamamlandığında deployment işlemini başlatabilirsiniz. Coolify, kodu çeker, build sürecini çalıştırır, container oluşturur ve uygulamayı yayına alır. Deployment loglarını dikkatle takip edin. Başarılı bir dağıtım sonunda uygulama belirlediğiniz domain üzerinden erişilebilir hale gelir.

7. Güncelleme ve Rollback Planı

Canlı ortamda her güncelleme öncesinde yedek almak önemlidir. Yeni deployment sonrasında hata yaşanırsa önce logları kontrol edin, gerekiyorsa önceki kararlı sürüme dönmek için rollback yani geri alma planınızı uygulayın. Coolify, deployment geçmişi ve log yönetimi sayesinde bu süreci daha izlenebilir hale getirir.

Güvenlik ve Optimizasyon Önerileri

coolify vds kurulumu yalnızca kurulum komutunu çalıştırmaktan ibaret değildir. Uzun vadeli, güvenli ve performanslı bir yapı için sunucu güvenliği, kaynak planlaması, yedekleme ve izleme adımlarını da uygulamanız gerekir.

SSH Güvenliği

Sunucunuzda parola ile SSH girişini devre dışı bırakıp anahtar tabanlı kimlik doğrulama kullanmanız önerilir. Ayrıca varsayılan SSH portunu değiştirmek, brute force yani kaba kuvvet saldırılarını azaltmaya yardımcı olabilir.

nano /etc/ssh/sshd_config

Dosya içinde gerekli ayarları yaptıktan sonra SSH servisini yeniden başlatabilirsiniz:

systemctl restart ssh

Kaynak Kullanımını İzleme

Coolify üzerinde birden fazla uygulama çalıştırıyorsanız CPU, RAM ve disk kullanımını düzenli takip etmeniz gerekir. Basit kontroller için aşağıdaki komutları kullanabilirsiniz:

htop
df -h
docker stats

• CPU takibi: Ani işlemci artışları hatalı sorgu, yoğun trafik veya build sürecinden kaynaklanabilir.
• RAM takibi: Yetersiz bellek container kapanmalarına ve performans düşüşüne neden olabilir.
• Disk takibi: Log dosyaları, image dosyaları ve yedekler zamanla disk alanını doldurabilir.

Docker Temizliği

Eski image yani imaj dosyaları, kullanılmayan containerlar ve cache verileri zamanla disk alanı tüketir. Dikkatli şekilde temizlik yapmak için şu komut kullanılabilir:

docker system prune -a

Bu komut kullanılmayan Docker kaynaklarını silebilir. Canlı ortamda çalıştırmadan önce hangi kaynakların silineceğini kontrol etmek ve yedek almak önemlidir.

Yedekleme Stratejisi

Veritabanları, yüklenen medya dosyaları, uygulama yapılandırmaları ve kritik ortam değişkenleri düzenli olarak yedeklenmelidir. Yedekler mümkünse aynı sunucuda değil, farklı bir lokasyonda saklanmalıdır. Böylece disk arızası, hatalı deployment veya yanlışlıkla silme gibi durumlarda hızlı geri dönüş yapılabilir.

Performans İpuçları

• Uygun sunucu seçimi: Trafik ve proje sayısına göre CPU ve RAM kapasitesi planlanmalıdır.
• Cache kullanımı: Laravel, WordPress veya Node.js projelerinde uygulama cache mekanizmaları etkinleştirilmelidir.
• Veritabanı optimizasyonu: Gereksiz indeksler, yavaş sorgular ve büyük log tabloları düzenli kontrol edilmelidir.
• Log rotasyonu: Log dosyalarının kontrolsüz büyümesi disk alanını tüketebilir.
• Ayrı ortamlar: Staging ve production ortamlarını ayırmak güncelleme risklerini azaltır.

Yaygın Hatalar ve Çözümleri

coolify vds kurulumu sırasında veya sonrasında bazı yaygın problemlerle karşılaşabilirsiniz. Bu bölümde en sık görülen hataları ve pratik çözüm yollarını bulabilirsiniz.

Panel Açılmıyor

Coolify paneline erişemiyorsanız öncelikle servislerin çalışıp çalışmadığını kontrol edin:

docker ps
ufw status

Panel portu kapalı olabilir, DNS henüz yayılmamış olabilir veya Coolify containerları beklenmedik şekilde durmuş olabilir. Sunucu IP adresiyle erişim denemesi yaparak sorunun DNS mi yoksa servis kaynaklı mı olduğunu ayırt edebilirsiniz.

SSL Sertifikası Oluşmuyor

SSL sertifikası alınamıyorsa domain A kaydının doğru IP adresine yönlendirildiğinden emin olun. Ayrıca 80 ve 443 portlarının açık olması gerekir. DNS değişikliklerinden sonra yayılım için bir süre beklemek gerekebilir.

Deployment Başarısız Oluyor

Deployment hataları genellikle build komutları, eksik environment variable, hatalı Dockerfile veya yetersiz sistem kaynağı nedeniyle oluşur. Coolify deployment loglarını inceleyerek hatanın hangi aşamada oluştuğunu görebilirsiniz. Örneğin bağımlılık kurulumu başarısız oluyorsa paket yöneticisi komutları ve sürüm uyumluluğu kontrol edilmelidir.

Uygulama 502 Hatası Veriyor

502 hatası çoğunlukla uygulama containerının doğru portta dinlememesi veya servis içinde çökmesi nedeniyle görülür. Uygulamanızın hangi porttan çalıştığını kontrol edin ve Coolify ayarlarında doğru portu tanımlayın.

docker logs UYGULAMA_CONTAINER_ADI --tail=100

Disk Alanı Hızla Doluyor

Docker image dosyaları, loglar ve yedekler disk alanını hızlı tüketebilir. df -h ile disk durumunu, docker system df ile Docker kaynak kullanımını kontrol edebilirsiniz. Gereksiz dosyaları silmeden önce yedekleme politikanızı gözden geçirin.

Sıkça Sorulan Sorular

Sonuç

Coolify VDS Sunucularda Nasıl Kurulur? Adım Adım Deployment Rehberi kapsamında, coolify vds kurulumu için gerekli sunucu hazırlıklarını, kurulum komutlarını, panel yapılandırmasını, domain ve SSL ayarlarını, deployment sürecini ve güvenlik önerilerini detaylı şekilde ele aldık. Coolify, Docker tabanlı modern uygulama dağıtımı yapmak isteyen geliştiriciler için esnek, pratik ve güçlü bir platformdur.

Başarılı bir kurulum için temiz bir VDS, güncel Linux işletim sistemi, açık portlar, doğru DNS kayıtları, güçlü güvenlik politikaları ve düzenli yedekleme planı kritik öneme sahiptir. Kurulumdan sonra uygulamalarınızı Git deposuna bağlayarak, environment variable değerlerini tanımlayarak ve deployment loglarını izleyerek sürdürülebilir bir yayınlama süreci oluşturabilirsiniz.

Eğer tüm bu adımları manuel olarak yönetmek yerine Coolify için hazır, performanslı ve uygulama yayınlamaya uygun bir altyapıyla başlamak istiyorsanız Corelux tarafından sunulan Coolify Hosting hizmetini inceleyebilirsiniz. Doğru yapılandırılmış bir VDS altyapısı ile Coolify, projelerinizi daha hızlı yayına almanıza ve geliştirme süreçlerinizi daha verimli yönetmenize yardımcı olur.