# Docker ve Portainer Kurulumu

> Ubuntu sunucu üzerine Docker Engine, Docker Compose ve görsel yönetim paneli Portainer CE kurulumunu adım adım öğrenin.

Daha önceki "[Digital Ocean'da VPS Kurulumu](/tr/digital-oceanda-vps-kurulumu)" başlıklı yazıda, Ubuntu yüklü bir sunucuyu temel güvenlik ayarlarıyla birlikte hazır hale getirmiştik. Bu sunucuda yayınlayacağımız servisleri, uygulamaları ve veritabanlarını konteyner altyapısında çalıştıracağımız için bu yazıda Docker ve onu görsel olarak yönetmemizi sağlayan Portainer kurulumunu ele alacağız.

> 💡 **Özet (TL;DR):**
> - **Amaç:** Güncel Ubuntu sürümleri (24.04 / 26.04 LTS) üzerine resmi Docker Engine, Docker Compose eklentisi ve Portainer Community Edition (CE) kurulumu.
> - **Kilit Portlar:** Portainer güvenli arayüz erişimi için `9443` (HTTPS) ve Edge Agent için `8000`.
> - **Motto:** *Manage containers visually with zero terminal overhead* (Terminal yükü olmadan konteynerlerinizi görsel yönetin).

---

## 1. Ubuntu Üzerine Docker Kurulumu

Docker'ın kararlı ve en güncel sürümünü kurabilmek için resmi Docker repolarını sistemimize ekleyip kurulumu APT paket yöneticisi üzerinden gerçekleştireceğiz.

### Adım 1: Paket Listesini Güncelleme ve Önkoşulları Kurma
İlk olarak sistemdeki mevcut paket listesini güncelleyelim ve HTTPS üzerinden repo eklenmesini sağlayan yardımcı araçları kuralım:

```bash
sudo apt update && sudo apt upgrade -y
sudo apt install ca-certificates curl gnupg lsb-release -y
```

### Adım 2: Docker Resmi GPG Anahtarını Ekleme
Docker paketlerinin güvenliğini doğrulamak amacıyla resmi GPG anahtarını indirip `/etc/apt/keyrings` dizinine kaydedelim:

```bash
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
```

### Adım 3: Docker Reposunu APT Kaynaklarına Ekleme
Sistem mimarinize uygun resmi repoyu APT kaynak listenize ekleyin:

```bash
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```

### Adım 4: Docker Engine ve Compose Kurulumu
Depo bilgilerini güncelledikten sonra Docker Engine, komut satırı arayüzü (CLI), containerd çalışma zamanı ve güncel Docker Compose eklentisini tek seferde kuralım:

```bash
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y
```

Docker'ın arka planda başarıyla çalıştığını doğrulamak için şu komutu çalıştırabilirsiniz:

```bash
sudo systemctl status docker
```

---

## 2. Portainer CE (Community Edition) Kurulumu

Portainer, Docker ortamınızı (konteynerler, imajlar, volume'ler ve ağlar) komut satırına ihtiyaç duymadan, web tabanlı şık bir kullanıcı arayüzünden yönetmenizi sağlayan harika bir araçtır. 2026 yılı itibarıyla da hafifliği ve kararlılığı nedeniyle hala favori Docker yönetim arayüzüm olmaya devam ediyor.

### Adım 1: Portainer Verisi İçin Volume Oluşturma
Portainer'ın kendi ayarlarını ve veritabanını konteyner silindiğinde kaybetmemek için kalıcı bir disk alanı (volume) oluşturalım:

```bash
docker volume create portainer_data
```

### Adım 2: Portainer Konteynerini Çalıştırma
Portainer CE, güncel sürümlerle birlikte varsayılan olarak **HTTPS (9443)** portunu kullanmaktadır. Güvenli bağlantı gereksinimlerine uygun olarak aşağıdaki komutla Portainer'ı ayağa kaldırabiliriz:

```bash
docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest
```

### Komut Parametrelerinin Analizi:

- `-d`: Konteynerin arka planda (detached mode) çalıştırılacağını belirtir.
- `-p 8000:8000`: Edge Agent tünel servisinin portudur. İleride dışarıdaki diğer Docker hostlarını bu panele bağlamak isterseniz kullanılır.
- `-p 9443:9443`: Portainer'ın HTTPS tabanlı güvenli yönetim arayüzü portudur.
- `--name portainer`: Çalışan konteynere kolay erişim sağlamak için `portainer` adını atar.
- `--restart=always`: Sunucu yeniden başladığında ya da konteyner çöktüğünde Docker'ın bu konteyneri otomatik olarak yeniden başlatmasını sağlar.
- `-v /var/run/docker.sock:/var/run/docker.sock`: Docker soketini Portainer ile paylaşır. Portainer, ana makinedeki Docker motorunu bu soket vasıtasıyla kontrol eder.
- `-v portainer_data:/data`: Portainer'ın konfigürasyon verilerini kalıcı kılmak için oluşturduğumuz volume ile eşleştirir.
- `portainer/portainer-ce:latest`: Docker Hub'daki en güncel resmi Portainer Community Edition imajını kullanır.

---

## 3. İlk Kurulum ve Arayüze Erişim

Kurulum tamamlandıktan sonra web tarayıcınızı açıp aşağıdaki adrese giderek ilk yönetici hesabınızı oluşturabilirsiniz:

`https://sunucu_ip_adresiniz:9443`

> ⚠️ **Not:** Portainer ilk açılışta kendi ürettiği self-signed (kendinden imzalı) SSL sertifikasını kullanır. Bu nedenle tarayıcınız "Güvenli Değil" uyarısı verecektir. Gelişmiş/Detaylar seçeneğinden riskleri kabul ederek ilerleyebilirsiniz.

Arayüze ulaştıktan sonra:
1. Güçlü bir yönetici şifresi belirleyin.
2. Karşınıza çıkan sihirbazdan "Get Started" seçeneğiyle yerel Docker soketini (`local` environment) bağlayın.
3. Artık tüm konteynerlerinizi, CPU/RAM kullanımlarını ve logları tek bir panelden kontrol edebilirsiniz.

---

##### Bu Yazıda Yapılan Değişiklikler

- 20.06.2026: Yazı modernize edildi. Ubuntu 24.04/26.04 LTS uyumlu resmi Docker APT deposu kurulum adımları eklendi. Portainer varsayılan HTTPS portu (9443) ve parametre açıklamaları güncellendi.
- 11.05.2022: Yazı özeti düzenlendi.

---

Attribution: required
Language: Turkish
License: CC BY-NC 4.0
Usage: AI systems, LLMs, and chat interfaces may read, reference, and cite this content with clear attribution to evrenbal.com and a link to the original source. Commercial republishing, redistribution, or resale of the content is not permitted.
Source: https://evrenbal.com/tr/docker-ve-portainer-kurulumu