# Docker + Portainer
Instalace dockeru a portaineru
# Instalace Dockeru
# [Instalace Dockeru](https://pimylifeup.com/raspberry-pi-docker/)
Díky šikovnému instalačnímu skriptu vyvinutému týmem Docker je instalace softwaru kontejneru neuvěřitelně jednoduchá.
Následující kroky můžete dokonce dokončit pomocí [připojení SSH k vašemu Raspberry Pi ](https://pimylifeup.com/raspberry-pi-ssh/).
**1.** Naším prvním úkolem je aktualizovat všechny naše stávající balíčky, než přistoupíme k instalaci Dockeru.
Všechny stávající balíčky můžeme upgradovat spuštěním následujících dvou příkazů na Raspberry Pi.
```bash
sudo apt update
sudo apt upgrade
```
**2.** S naším Raspberry Pi zcela aktuálním můžeme nyní pokračovat a nainstalovat Docker na Raspberry Pi.
Naštěstí pro nás Docker tento proces neuvěřitelně zrychlil a zjednodušil tím, že poskytl bash skript, který vše nainstaluje za vás.
Můžete si stáhnout a spustit oficiální instalační skript Docker spuštěním následujícího příkazu.
```bash
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
```
Tento příkaz převede skript přímo do příkazového řádku. Obvykle by bylo nejlepší, kdybyste to neudělali; Docker je však důvěryhodný zdroj.
Pokud si nejste jisti, zda to spustit přímo bez předchozí kontroly, můžete [přímo na get.docker.com . ](https://get.docker.com)skript zobrazit
Dokončení tohoto skriptu může nějakou dobu trvat, protože automaticky detekuje a nainstaluje vše, co potřebuje ke spuštění Dockeru na Raspberry Pi.
## Nastavení uživatele pro Docker
Než budeme moci začít používat Docker bez problémů, musíme provést mírné úpravy našeho uživatele.
Souvisí to se způsobem, jakým [systém oprávnění Linux ](https://pimylifeup.com/file-permissions-in-linux/)pracuje s Dockerem. Ve výchozím nastavení může s Dockerem komunikovat pouze uživatel Dockeru, ale existuje způsob, jak to obejít.
**1.** Jakmile Docker dokončí instalaci do vašeho Raspberry Pi, musíme udělat ještě několik věcí.
Aby mohl jiný uživatel komunikovat s Dockerem, musí být přidán do `docker`skupina.
Takže naším dalším krokem je přidání našeho aktuálního uživatele do `docker`skupinu [pomocí příkazu usermod ](https://pimylifeup.com/usermod-command/), jak je uvedeno níže. Používáním " `$USER`” vkládáme proměnnou prostředí, která ukládá jméno aktuálního uživatele.
```bash
sudo usermod -aG docker $USER
```
Pokud do skupiny nepřidáme našeho uživatele, nebudeme moci komunikovat s Dockerem bez spuštění jako uživatel root.
Chcete-li se dozvědět více o oprávněních a skupinách v Linuxu, podívejte se na naše [oprávnění k souborům v příručce Linux ](https://pimylifeup.com/file-permissions-in-linux/).
**2.** Protože jsme u našeho uživatele provedli nějaké změny, budeme se nyní muset odhlásit a znovu přihlásit, aby se změny projevily.
Můžete se odhlásit spuštěním následujícího příkazu v terminálu.
```bash
logout
```
**3.** Jakmile se znovu přihlásíte, můžete si ověřit, že skupina dockerů byla úspěšně přidána k vašemu uživateli spuštěním následujícího příkazu.
```plaintext
groups
```
Tento příkaz zobrazí seznam všech skupin, kterých je aktuální uživatel součástí. Pokud vše fungovalo, jak má, skupina `docker`by zde mělo být uvedeno.
## Testování instalace Dockeru na Raspberry Pi
Když je Docker nyní nastaven na našem Raspberry Pi, měli bychom nyní pokračovat a testovat, abychom se ujistili, že funguje.
**1.** Chcete-li otestovat, zda Docker funguje, budeme pokračovat a spustíme následující příkaz na našem Pi.
Tento příkaz řekne Dockeru, aby si stáhl, nastavil a spustil kontejner dockeru s názvem „ **hello-world** .
```plaintext
docker run hello-world
```
**2.** Pokud jste úspěšně nainstalovali Docker do vašeho Raspberry Pi, měli byste vidět zprávu s následujícím textem.
```plaintext
Hello from Docker!
This message shows that your installation appears to be working correctly.
```
## Závěr
Nyní můžete bezpečně začít používat Docker pro svůj projekt, jako je nastavení Docker swarm s vaším Raspberry Pi.
Docker kontejnery jsou skvělý způsob, jak rychle nasadit software do vašeho zařízení.
Chcete-li si usnadnit život při správě kontejnerů Docker, [můžete také nastavit Portainer na zařízení Pi ](https://pimylifeup.com/raspberry-pi-portainer/). Portainer je úhledný kus softwaru, který vám umožňuje vytvářet a spravovat kontejnery ve webovém rozhraní.
Pokud jste našli nějaké problémy s instalací Dockeru, pak neváhejte napsat komentář níže.
# Instalace Portaineru
### Instalace a aktualizace Portaineru (Docker)
Tento návod slouží k instalaci Portainer CE pomocí Dockeru. Veškerá data a nastavení budou uložena v Docker volume, takže o ně při aktualizaci nepřijdete.
## 1. Instalace Portaineru
Nejdříve vytvoříme svazek pro data a následně spustíme samotný kontejner.
**Krok 1: Vytvoření volume pro trvalá data**
```
sudo docker volume create portainer_data
```
Ověření:
```yaml
docker volume inspect portainer_data
```
****Krok 2: Spuštění kontejneru Portainer****
```yaml
docker run -d \
--name=portainer \
--restart=always \
-p 9000:9000 \
-p 9443:9443 \
-v /var/run/docker.sock:/var/run/docker.sock \
-v portainer_data:/data \
portainer/portainer-ce:latest
```
- **-p 9000:9000**: Přístup přes HTTP (nezabezpečený).
- **-p 9443:9443**: Přístup přes HTTPS (zabezpečený – doporučeno).
- **--name=portainer**: Pojmenování kontejneru pro snadnou správu.
- **--restart=always**: Portainer se automaticky spustí po restartu serveru.
- **-v /var/run/docker.sock...**: Umožňuje Portaineru ovládat Docker na vašem serveru.
- **-v portainer\_data:/data**: Propojení vytvořeného svazku s vnitřkem kontejneru (vaše data).
### Co je kritické:
Parametr
Proč
`-v portainer_data:/data`
**ukládá stack YAML, uživatele, nastavení**
`--restart=always`
přežije reboot
`docker.sock`
správa Dockeru
3️⃣ Ověření správné instalace (POVINNÉ)
```
docker inspect portainer | grep -A10 Mounts
```
Správný výstup MUSÍ obsahovat:
"Type": "volume",
"Source": "/var/lib/docker/volumes/portainer\_data/\_data",
"Destination": "/data"
Pokud to tam není → **OKAMŽITĚ STOP** – instalace je špatně.
---
#### 🔁 BEZPEČNÁ AKTUALIZACE PORTAINERU
#### (bez ztráty YAML)
> Aktualizuje se **POUZE kontejner**, **NIKDY volume**
Tento postup použijte vždy, když chcete přejít na novější verzi. Data zůstanou zachována.
**Krok 1: Stažení nejnovější verze obrazu z internetu**
```
sudo docker pull portainer/portainer-ce:latest
```
**Krok 2: Zastavení aktuálně běžícího Portaineru + **Krok 3: Odstranění starého kontejneru** *(Nebojte se, data jsou bezpečně v portainer\_data volume)***
```
sudo docker stop portainer
sudo docker rm portainer
```
***Krok 4: Spuštění Portaineru znovu (už z nové verze)***
```yaml
docker run -d \
--name=portainer \
--restart=always \
-p 9000:9000 \
-p 9443:9443 \
-v /var/run/docker.sock:/var/run/docker.sock \
-v portainer_data:/data \
portainer/portainer-ce:latest
```
➡️ Po přihlášení:
- Stacky
- YAML
- Historie
- Credentials
**= VŠECHNO ZACHOVÁNO**
### Přihlášení do rozhraní
Po instalaci nebo aktualizaci otevřete prohlížeč a zadejte:
- **HTTP:** `http://vase-ip-adresa:9000`
- **HTTPS:** `https://vase-ip-adresa:9443`
*Poznámka: Jak jsme si potvrdili, veškeré další programy už budete instalovat přes Portainer UI v sekci **Stacks** s využitím Environment Variables.*
##### ⚠️ 2) SMAZAT VŠECHNY IMAGE, KTERÉ NEPOUŽÍVÁ ŽÁDNÝ KONTEJNER
Tímto smažeš:
- **i staré image, které nejsou dangling, ale nemá je přiřazen žádný kontejner:**
```yaml
docker image prune -a -f
```
#### App Templates:
```
https://raw.githubusercontent.com/Lissy93/portainer-templates/main/templates_v3.json
```
### Konfigurace Porttaineru na vašem Raspberry Pi
Když se poprvé připojíte k webovému rozhraní Portaineru, budete muset provést některé počáteční kroky nastavení.
Nebojte se, protože tyto jsou neuvěřitelně přímočaré a pomáhají zajistit, že bude fungovat tak, jak chceme.
**1.** Při prvním spuštění webového rozhraní Portaineru si budete muset vytvořit účet správce.
Chcete-li vytvořit tento administrátorský účet, musíte mu dát uživatelské jméno ( **1.** ).
Dále budete muset tomuto novému účtu přiřadit heslo ( **2.** ). Portainer vyžaduje, abyste měli hesla dlouhá alespoň 12 znaků.
Jakmile nastavíte požadované uživatelské jméno a heslo, click" `Create user`” pro dokončení jeho vytváření.
**2.** Nyní musíme vybrat, jaký druh prostředí kontejneru chceme, aby Porttainer spravoval.
V našem případě musíme vybrat `Docker`Možnost **1.** ).
Jakmile tuto možnost vyberete, clicka `Connect`tlačítko ( **2.** ).
**3.** Nyní byste měli mít Porttainer úspěšně spuštěný na vašem Raspberry Pi.
Nyní jej můžete použít ke správě kontejnerů Docker běžících na vašem zařízení.
### Základní použití uživatelského rozhraní Portainer
Tato část ukáže základy používání Portainer UI k vytvoření nového kontejneru Docker.
Podle těchto kroků si Portainer stáhne obrázek kontejneru do vašeho Raspberry Pi a nastaví jej.
**1.** Když vstoupíte do rozhraní Portainer, měli byste vidět obrazovku jako níže.
Můžete vidět, že naše instalace Raspberry Pi Docker je uvedena jako koncový bod Portainer. Clicktento koncový bod otevřete jeho nastavení.
**2.** Zde uvidíte rychlý přehled Dockeru spuštěného ve vašem systému.
Na této obrazovce se zobrazí počet kontejnerů, svazků, obrazů a sítí ve vašem systému.
Chcete-li zjistit, jaké kontejnery běží na vašem Raspberry Pi, click" `Containers`“ na postranním panelu.
**3.** Porttaineru se nyní zobrazí seznam kontejnerů aktuálně nastavených na vašem zařízení ( **1.** ).
Když vyberete kontejner, budete jej moci ovládat volbou, zda chcete kontejner spustit, zastavit, zabít ( **2.** ).
Pokud chcete přidat zcela nový kontejner, můžete click" `Add container`tlačítko “ ( **3.** ).
**3.** A konečně, tato obrazovka je ta, která vám umožní vytvářet nové kontejnery v Porttaineru.
Pomocí této možnosti můžete zvolit různá nastavení.
Nejprve musíte definovat název, který chcete tomuto kontejneru přidělit ( **1.** ).
Poté musíte vybrat obrázek, který má Portainer natáhnout do vašeho Raspberry Pi ( **2.** ).
Je dokonce možné nastavit síťové porty, které má váš kontejner Docker používat ( **3.** ).
Kromě toho můžete také ovládat, kdo může tento kontejner spravovat ve webovém rozhraní Portaineru ( **4.** ).
Nakonec je zde řada pokročilých možností, které můžete nastavit pomocí pole v dolní části stránky ( **5.** ). Ten, který budete pravděpodobně konfigurovat nejvíce, je „ `Restart Policy`“.
Pomocí toho můžete zajistit, že se váš kontejner dockeru automaticky restartuje, když se Raspberry Pi restartuje.
Jakmile budete spokojeni se všemi nastaveními nového kontejneru Docker, můžete click" `Deploy the container`tlačítko “ (6.)
## Závěr
V tuto chvíli byste měli mít úspěšně spuštěn Portainer na vašem Raspberry Pi.
Portainer je šikovný software, který vám umožní snadno spravovat vaše kontejnery Docker.
Pomocí webového rozhraní můžete vytvářet, upravovat a mazat své kontejnery.
Pokud máte nějaké problémy se spuštěním Porttaineru na vašem Raspberry Pi, zanechte prosím komentář níže.
Měli byste se také podívat na naše další [projekty Raspberry Pi ](https://pimylifeup.com/category/projects/), abyste viděli, jak jinak můžete využít své Pi.
# Instalace Portaineru NEW
Tady máš **CELÝ POSTUP OD NULY**, přesně **tak, jak chceš**:
- ✔ Portainer **instalovaný jako stack přes YML**
- ✔ **VŠECHNO v `/opt/stack/`**
- ✔ **file-based stack** (Portainer YAML **nevlastní**)
- ✔ **aktualizace / reinstalace Portaineru = BEZ `LIMITED`**
- ✔ odpovídá tomu, co chceš dlouhodobě provozovat
Žádné alternativy, žádné teorie. **Toto je správný a bezpečný způsob.**
---
# 🎯 CÍLOVÝ STAV
`/opt/stack/├── portainer/│ └── docker-compose.yml├── portainer-data/└── (ostatní stacky později stejným stylem)`
---
# 0️⃣ PŘEDPOKLADY
- Docker **už máš** ✅
- Používáš **docker compose plugin** (`docker compose`)
- Vše děláš jako `root` nebo přes `sudo`
Ověření (jen pro klid):
📌 **DŮLEŽITÉ**
- `portainer-data` je **perzistence**
- **nikdy** nepoužívej Docker volume typu `portainer_data`
- jen **bind mount do `/opt`**
---
# 2️⃣ VYTVOŘ YML PRO PORTAINER (FILE-BASED STACK)
Soubor:
✔ YAML je **soubor na disku**
✔ Portainer ho **nikdy nebude ukládat do DB**
✔ upgrade-safe
---
# 3️⃣ NASAZENÍ STACKU (RUČNĚ, BEZ UI)
⚠️ **Tohle je záměr** – první start vždy ručně.
`cd /opt/stack/portainerdocker compose up -d`
Ověření:
`docker ps | grep portainer`
---
# 4️⃣ PRVNÍ PŘIHLÁŠENÍ DO PORTAINERU (KRITICKÉ)
Otevři v prohlížeči:
`https://IP_SERVERU:9443`
### Nastav:
- vytvoř **JEDEN admin účet**
- **neměň ho**
- **nemaž**
- **žádní další uživatelé** (pokud nejsou nutní)
📌 **RBAC změny = častý zdroj LIMITED**
---
# 5️⃣ JAK TENHLE STACK ZAREGISTRUJEŠ DO PORTAINERU (SPRÁVNĚ)
Teď to důležité.
### V Portainer UI:
1. **Stacks → Add stack**
2. **Build method: *File upload / Path***
3. **NE web editor**
4. Zadej **cestu k souboru**:
`cd /opt/stack/portainerdocker compose pulldocker compose up -d`
➡️ NIC jiného se nedotkne
➡️ ŽÁDNÝ stack se nepřepne do LIMITED
---
# 7️⃣ REINSTALACE PORTAINERU (NUCLEAR SAFE)
Když se cokoliv posere:
`docker stop portainerdocker rm portainer`
❗ **Stacky mimo Portainer běží dál** ❗
Pak znovu:
`cd /opt/stack/portainerdocker compose up -d`
A v Portainer UI:
- znovu **Stacks → Add stack**
- znovu **Path**
- stejný soubor
- hotovo
---
# 8️⃣ PRAVIDLA, KTERÁ NESMÍŠ PORUŠIT (DŮLEŽITÉ)
❌ nepoužívej **Web editor**
❌ nepoužívej **Git stack**
❌ nekopíruj YML do UI
❌ neupravuj stack v Portaineru
✔ YML **VŽDY** upravuj v:
`/opt/stack//docker-compose.yml`
✔ Pak:
`docker compose up -d`
nebo **Redeploy** (file-based je OK)
---
# 🧠 PROČ TOHLE FUNGUJE (STRUČNĚ)
- Portainer **nevlastní YAML**
- nemá co porovnávat při upgradu
- nemá co označit jako „externí“
- ownership zůstává konzistentní
- **LIMITED NEMÁ JAK VZNIKNOUT**
---
# ✅ FINÁLNÍ CHECKLIST
✔ `/opt/stack/portainer/docker-compose.yml` existuje
✔ Portainer stack je **file-based**
✔ Data jsou v `/opt/stack/portainer-data`
✔ Žádné Docker volume
✔ Jeden admin
✔ Žádný Web editor
➡️ **MÁŠ HOTOVO A BEZPEČNO**