Konteyner blokları ve yönetim ekranıyla Docker altyapısı; Docker ve Portainer kurulumu.

Pardus Docker ve Portainer kurulumu: 23 ve 25 rehberi

Yazar:Appz

Pardus üzerinde Docker Engine kurarken dağıtımın Debian tabanına uygun depo seçmek gerekir. Bu rehber Pardus 23 için Bookworm, Pardus 25 için Trixie deposunu kullanarak Engine, Compose ve Portainer kurulumunu açıklar.

1. Eski Sürümlerin Temizlenmesi

Yeni Docker Engine kurulumu öncesinde çakışabilecek paketleri kontrol edin. Çalışan Docker, Podman veya containerd servisiniz varsa önce konteynerleri, volume verilerini ve bağımlı uygulamaları envantere alın. Paket kaldırma işlemini yedek ve bakım planı olmadan uygulamayın.

Terminali açın ve şu komutu uygulayın:

for paket in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do
  dpkg-query -W -f='${db:Status-Status}\n' "$paket" 2>/dev/null | grep -qx installed && echo "$paket"
done
# Yalniz listelenen ve kaldirilmasina karar verilen paketler icin:
# sudo apt remove PAKET_ADICode language: PHP (php)
Pardus docker kurulumu öncesinde sistemde çakışma yaratabilecek eski docker paketlerinin terminalden kaldırılması.
Eski sürümleri (docker.io) kaldırarak temiz bir başlangıç yapıyoruz.

2. Gerekli Ön Hazırlık Paketlerinin Kurulumu

Docker’ın resmi deposuna güvenli bir şekilde (HTTPS üzerinden) erişebilmek için bazı sertifika ve araçlara ihtiyacımız var. Önce paket listemizi güncelleyelim ve gerekli araçları kuralım.

sudo apt-get update
sudo apt-get install ca-certificates curl gnupgCode language: JavaScript (javascript)
Güvenli bir Pardus docker kurulumu için gerekli olan ca-certificates ve curl paketlerinin sisteme yüklenmesi.
Güvenli bağlantı ve sertifika işlemleri için gerekli ön hazırlık paketlerini kuruyoruz.

3. Docker GPG Anahtarının Eklenmesi

Sistemin, indireceğimiz paketlerin orijinalliğini doğrulayabilmesi için Docker’ın resmi GPG anahtarını (Keyring) sistemimize eklememiz gerekiyor.

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpgCode language: JavaScript (javascript)
Pardus docker kurulumu adımlarında paketlerin güvenliğini doğrulamak için resmi GPG anahtarının eklenmesi.
Resmi paketleri doğrulayabilmek için Docker GPG anahtarını sisteme ekliyoruz.

4. Docker Deposunun Tanımlanması

Anahtarı ekledikten sonra, Pardus’un paket yöneticisine (APT) Docker’ın kararlı (stable) deposunun adresini tanıtıyoruz. Pardus, Debian tabanlı olduğu için Debian depolarını kullanacağız.

. /etc/os-release
case "$VERSION_ID" in
  23|23.*) docker_codename=bookworm ;;
  25|25.*) docker_codename=trixie ;;
  *) echo "Pardus sürümünü ve Debian tabanını doğrulayın."; exit 1 ;;
esac
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $docker_codename stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/nullCode language: PHP (php)
Pardus docker kurulumu için sistemin kaynak listesine (sources.list) Docker resmi deposunun eklenmesi.
Pardus’un (Debian) kararlı sürümüne uygun resmi Docker deposunu tanımlıyoruz.

5. Docker Engine ve Araçlarının Kurulumu

Artık her şey hazır! Paket listesini tekrar güncelleyerek Docker Engine, CLI (Komut Satırı Arayüzü), Containerd ve Docker Compose eklentisini tek seferde kuruyoruz.

sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-pluginCode language: CSS (css)
Terminal üzerinden apt install komutu kullanılarak Pardus docker kurulumu ve containerd paketlerinin yüklenmesi.
Docker Engine, CLI ve Compose eklentisini tek komutla kuruyoruz.

6. Kurulumun Doğrulanması (Hello World)

Pardus docker kurulumunun başarılı olup olmadığını test etmek için Docker’ın klasik “Hello World” imajını çalıştıralım. Bu komut, Docker’ın internete çıkıp imajı çekebildiğini ve çalıştırabildiğini gösterir.

sudo docker run hello-world
Başarılı bir Pardus docker kurulumu sonrasında hello-world imajı çalıştırılarak sistemin test edilmesi.
Kurulumun başarısını ‘Hello World’ imajını çalıştırarak doğruluyoruz.

Eğer “Hello from Docker!” mesajını görüyorsanız, kurulum başarılıdır!

7. Sudo Olmadan Docker Kullanımı (Yetkilendirme)

Docker grubuna ekleme isteğe bağlıdır ve root düzeyinde erişim sağlar. Yalnız bu yetkiyi vermek istediğiniz kullanıcılar için uygulayın; aksi halde sudo docker kullanın.

sudo usermod -aG docker $USERCode language: PHP (php)
Pardus docker kurulumu tamamlandıktan sonra mevcut kullanıcıyı docker grubuna ekleyerek sudo olmadan kullanma ayarı.
Her komutta ‘sudo’ yazmamak için kullanıcımızı docker grubuna ekliyoruz.

8. Grup Değişikliğinin Uygulanması

Gruba ekleme işleminin oturumu kapatıp açmadan hemen devreye girmesi için şu komutu kullanın:

newgrp docker
Pardus docker kurulumu sonrası yapılan grup değişikliğinin oturumu kapatmadan aktif edilmesi.
Oturumu kapatıp açmaya gerek kalmadan grup değişikliğini uyguluyoruz.

Artık sudo yazmadan docker ps gibi komutları kullanabilirsiniz.

9. Docker Compose Sürüm Kontrolü

Yeni nesil Docker kurulumlarında “Docker Compose” artık harici bir dosya değil, Docker’ın bir eklentisi (docker compose) olarak gelir. Sürümü kontrol edelim:

docker compose version
Pardus docker kurulumu ile birlikte gelen güncel Docker Compose eklentisinin sürümünün kontrol edilmesi.
Docker Compose eklentisinin sorunsuz kurulduğunu sürüm kontrolü ile teyit ediyoruz.

10. Bonus: Portainer ile Görsel Yönetim Arayüzü

Docker’ı terminalden yönetmek istemeyenler için yaygın kullanılan arayüz olan Portainer‘ı kuralım. Portainer da bir Docker konteyneri olarak çalışır.

sudo docker volume create portainer_data
sudo docker run -d -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:lts
sudo docker logs portainerCode language: JavaScript (javascript)
Pardus docker kurulumu üzerine görsel yönetim paneli olan Portainer konteynerinin kurulması ve çalıştırılması.
Sistemi görsel arayüzden yönetmek için Portainer konteynerini ayağa kaldırıyoruz.

Tarayıcıdan https://SUNUCU_IP:9443 adresini açın. Docker günlüklerinde ilk kurulum token bilgisi istenip istenmediğini kontrol edin ve Portainer’ın kullandığınız sürümüne ait ilk kurulum belgesini izleyin. Güvenilir bir TLS sertifikasını ayrıca yapılandırın.

Sonuç: Pardus Docker Kurulumu Tamamlandı

Pardus’un kararlı altyapısı ile Docker’ın esnekliğini birleştirerek, projelerinizi izole ve güvenli bir ortamda çalıştırmaya artık hazırsınız.

Elinizde şu an;

  • Resmi depolardan sürekli güncellenen bir Docker Engine,
  • Çoklu konteyner yapılarını yönetebilen Docker Compose,
  • Ve tüm bu sistemi komut satırına gerek kalmadan yönetmenizi sağlayan Portainer paneli bulunuyor.

Artık ilk konteynerinizi ayağa kaldırabilir, kendi sunucunuzu yönetebilir ve açık kaynak dünyasının sınırsız imkanlarını keşfetmeye başlayabilirsiniz. İyi çalışmalar!

Sıkça Sorulan Sorular

Pardus 25 için Bookworm deposu doğru mu?

Pardus 25 Debian 13 tabanlıdır; Docker deposunda trixie seçilmelidir. Pardus 23 için bookworm kullanılır. Depo kod adını Pardus kod adıyla değiştirmeyin.

Docker grubuna eklenmek ne anlama gelir?

Docker daemon erişimi, root düzeyinde işlem yapma olanağı sağlar. Gruba yalnız bu yetkiyi vermek istediğiniz kullanıcıları ekleyin; alternatif olarak sudo kullanın.

Portainer arayüzüne hangi porttan ulaşırım?

Bu örnekte HTTPS üzerinden 9443 kullanılır. 9000 eski HTTP erişimi içindir ve gerekli değildir. İlk kurulum token gereksinimi kullanılan Portainer sürümüne bağlıdır.

Çakışan Docker paketlerini kaldırmadan önce mevcut konteyner, volume ve servisleri envantere alın. Bu işlem çalışan kurulumu etkileyebilir; veriyi yedekleyin ve bakım penceresinde ilerleyin.

Kaynaklar ve inceleme notu

Bu sayfa 6 Ekim 2026 tarihinde anlatım, sürüm ayrımları ve kaynaklar açısından gözden geçirildi. Belge kontrolü, yeni bir fiziksel cihazda veya üretim sunucusunda uçtan uca test yapıldığı anlamına gelmez.

İlginizi Çekebilir