# 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
---
# 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):
---
# 1️⃣ VYTVOŘ STRUKTURU (POVINNÉ)
📌 **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:
Obsah **VLOŽ DOSLOVA**:
✔ 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ě.
Ověření:
---
# 4️⃣ PRVNÍ PŘIHLÁŠENÍ DO PORTAINERU (KRITICKÉ)
Otevři v prohlížeči:
### 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**:
5. Deploy
📌 Portainer:
- uloží si **jen cestu**
- **NEOBSAH** YML
- **nevznikne LIMITED**
- upgrade je bezpečný
---
# 6️⃣ AKTUALIZACE PORTAINERU (BEZ RIZIKA)
Kdykoliv později:
➡️ NIC jiného se nedotkne
➡️ ŽÁDNÝ stack se nepřepne do LIMITED
---
# 7️⃣ REINSTALACE PORTAINERU (NUCLEAR SAFE)
Když se cokoliv posere:
❗ **Stacky mimo Portainer běží dál** ❗
Pak znovu:
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:
✔ Pak:
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**