diff --git a/README.md b/README.md index 5655e5e..2a697c9 100644 --- a/README.md +++ b/README.md @@ -1,39 +1,301 @@ # mates-docker-services -Docker Compose šablony pro 14 self-hosted služeb. -Toto je **přesná kopie** `docker-compose.yml` souborů z běžícího serveru. +Docker Compose šablony pro **14 self-hosted služeb**. +Toto jsou **přesné kopie** `docker-compose.yml` souborů z běžícího serveru. -## Služby +> **Jsi začátečník?** Čti od [Začínáme](#zaciname) – vše krok za krokem. -| Služba | Port | Image | -|---|---|---| -| audiobookshelf | 13378 | advplyr/audiobookshelf | -| calibre-web | 8083 | linuxserver/calibre-web | -| erugo | 61080 | wardy784/erugo | -| gitea | 3000, 222 | gitea/gitea | -| jotty | 1122 | mrx23dotcom/jotty | -| jswiki | 9180 | linuxserver/wikijs | -| nextcloud-aio | 8155 | nextcloud/all-in-one | -| nginx-proxy-manager | 80, 443, 81 | jc21/nginx-proxy-manager | -| plex | 32400 | linuxserver/plex | -| portainer | 9000, 9443 | portainer/portainer-ce | -| rustdesk | 21115-21119 | rustdesk/rustdesk-server | -| speedtest | 8072 | linuxserver/speedtest-tracker | -| vaultwarden | 2999 | vaultwarden/server | -| watchtower | – | containrrr/watchtower | +--- -## Použití +## 📦 Služby (14) + +| Služba | Port | Image | Účel | +|---|---|---|---| +| **audiobookshelf** | 13378 | advplyr/audiobookshelf | Audio knihovna | +| **calibre-web** | 8083 | linuxserver/calibre-web | E-knihovna | +| **erugo** | 61080 | wardy784/erugo | Sdílení souborů | +| **gitea** | 3000, 222 | gitea/gitea | Self-hosted Git | +| **jotty** | 1122 | mrx23dotcom/jotty | Poznámky a checklisty | +| **jswiki** | 9180 | linuxserver/wikijs | Wiki | +| **nextcloud-aio** | 8155 | nextcloud/all-in-one | Cloud (soubory, kalendář) | +| **nginx-proxy-manager** | 80, 443, 81 | jc21/nginx-proxy-manager | Reverzní proxy + HTTPS | +| **plex** | 32400 | linuxserver/plex | Media server | +| **portainer** | 9000, 9443 | portainer/portainer-ce | Docker UI | +| **rustdesk** | 21115-21119 | rustdesk/rustdesk-server | Remote desktop | +| **speedtest** | 8072 | linuxserver/speedtest-tracker | Speed test tracker | +| **vaultwarden** | 2999 | vaultwarden/server | Hesla | +| **watchtower** | – | containrrr/watchtower | Auto-update kontejnerů | + +--- + +## 🚀 Začínáme + +### Krok 1: Naklonuj repo + +```bash +git clone http://:3000/mates/mates-docker-services.git +cd mates-docker-services +``` + +### Krok 2: Vyber službu + +```bash +cd portainer +``` + +### Krok 3: Nasaď službu ```bash -cd -cp .env.example .env # pokud existuje docker compose up -d ``` -## Detailní návody +To je vše! Služba se stáhne, nastartuje a běží. -Každá služba má `README.md` s odkazem na Jotty knowledge base (kategorie podle typu). +### Krok 4: Ověř -## Licence +```bash +docker compose ps # status +docker compose logs -f # logy +``` + +--- + +## 📚 Detail ke každé službě + +### audiobookshelf (`13378`) + +Audio knihovna. Stream audioknih, podcastů. Sledování pokroku. + +```bash +cd audiobookshelf +docker compose up -d +# Otevri http://:13378 a dokonci setup +``` + +### calibre-web (`8083`) + +Web čtečka e-knihoven. + +```bash +cd calibre-web +docker compose up -d +# Otevri http://:8083 a dokonci setup +``` + +### erugo (`61080`) + +Jednoduché sdílení souborů s heslem a expirací. + +```bash +cd erugo +docker compose up -d +``` + +### gitea (`3000`, `222`) + +Self-hosted Git server. + +```bash +cd gitea +docker compose up -d +# Otevri http://:3000 a dokonci install wizard +# SSH pristup: ssh://git@:222 +``` + +### jotty (`1122`) + +Poznámky a checklisty (knowledge base). + +```bash +cd jotty +docker compose up -d +# Otevri http://:1122 +``` + +### jswiki (`9180`) + +Wiki. + +```bash +cd jswiki +docker compose up -d +# Otevri http://:9180 a dokonci setup +``` + +### nextcloud-aio (`8155`) + +Cloud (soubory, kalendář, kontakty). + +```bash +cd nextcloud-aio +docker compose up -d +# Otevri http://:11000 (admin) +# Nasleduj install wizard +``` + +### nginx-proxy-manager (`80`, `443`, `81`) + +Reverzní proxy + HTTPS (Let's Encrypt). + +```bash +cd nginx-proxy-manager +docker compose up -d +# Admin UI: http://:81 +# Default login: admin@example.com / changeme (ZMEN!) +``` + +### plex (`32400`) + +Media server. + +```bash +cd plex +docker compose up -d +# Otevri http://:32400/web +``` + +### portainer (`9000`, `9443`) + +Docker UI. + +```bash +cd portainer +docker compose up -d +# Otevri http://:9000 +# Vytvor admin ucet +``` + +### rustdesk (`21115-21119`) + +Remote desktop relay server. + +```bash +cd rustdesk +docker compose up -d +# Verejny klic z logu hbbs pridej do RustDesk klienta +``` + +### speedtest (`8072`) + +Speed test tracker. + +```bash +cd speedtest +docker compose up -d +# Otevri http://:8072 +``` + +### vaultwarden (`2999`) + +Správce hesel (Bitwarden kompatibilní). + +```bash +cd vaultwarden +docker compose up -d +# Otevri https://vault.example.com (za HTTPS pres NPM) +``` + +### watchtower + +Auto-update všech kontejnerů (monitor-only mode). + +```bash +cd watchtower +docker compose up -d +# Defaultne jen upozornuje, neaktualizuje +# Zmen WATCHTOWER_MONITOR_ONLY=false pro auto-update +``` + +--- + +## 🏗 Struktura + +``` +mates-docker-services/ +├── README.md # Tento soubor +├── LICENSE # MIT +├── audiobookshelf/ +│ ├── docker-compose.yml # Compose soubor +│ └── README.md # Detailní návod +├── calibre-web/ +│ ├── docker-compose.yml +│ └── README.md +├── ... (12 dalsich sluzeb) +└── (kazda sluzba ma docker-compose.yml + README.md) +``` + +--- + +## 🔧 Správa služeb + +### Update jedné služby + +```bash +cd +docker compose pull +docker compose up -d +``` + +### Update všech služeb + +```bash +for d in */; do + cd "$d" + docker compose pull + docker compose up -d + cd .. +done +``` + +### Zastavit službu + +```bash +cd +docker compose stop +``` + +### Restart + +```bash +docker compose restart +``` + +### Logy + +```bash +docker compose logs -f --tail=100 +``` + +### Smazat (data jsou v ./data/) + +```bash +docker compose down -v # POZOR: smaze i volumes +``` + +--- + +## 🔐 Bezpečnost + +- ✅ **Žádné hesla v `docker-compose.yml`** – vše v `.env` +- ✅ **Restart policy `unless-stopped`** – kontejner se nespustí po rebootu +- ✅ **Health checks** – monitoring přes Portainer +- ✅ **Log rotation** – max 10 MB × 3 soubory +- ✅ **Bridge networks** – izolace mezi službami + +--- + +## 📚 Související + +- **Jotty:** knowledge base (detailní návody pro každou službu) +- **mates-ansible:** automatické nasazení přes Ansible +- **mates-install-scripts:** Docker zálohy a cleanup + +--- + +## 📜 Licence MIT – viz [LICENSE](LICENSE) + +--- + +**Poslední update:** 2026-08-01