mates-docker-services/README.md

# mates-docker-services

Docker Compose šablony pro **14 self-hosted služeb**.
Toto jsou **přesné kopie** `docker-compose.yml` souborů z běžícího serveru.

> **Jsi začátečník?** Čti od [Začínáme](#zaciname) – vše krok za krokem.

---

## 📦 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://<server-ip>:3000/mates/mates-docker-services.git
cd mates-docker-services
```

### Krok 2: Vyber službu

```bash
cd portainer
```

### Krok 3: Nasaď službu

```bash
docker compose up -d
```

To je vše! Služba se stáhne, nastartuje a běží.

### Krok 4: Ověř

```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://<server-ip>:13378 a dokonci setup
```

### calibre-web (`8083`)

Web čtečka e-knihoven.

```bash
cd calibre-web
docker compose up -d
# Otevri http://<server-ip>: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://<server-ip>:3000 a dokonci install wizard
# SSH pristup: ssh://git@<server-ip>:222
```

### jotty (`1122`)

Poznámky a checklisty (knowledge base).

```bash
cd jotty
docker compose up -d
# Otevri http://<server-ip>:1122
```

### jswiki (`9180`)

Wiki.

```bash
cd jswiki
docker compose up -d
# Otevri http://<server-ip>:9180 a dokonci setup
```

### nextcloud-aio (`8155`)

Cloud (soubory, kalendář, kontakty).

```bash
cd nextcloud-aio
docker compose up -d
# Otevri http://<server-ip>: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://<server-ip>:81
# Default login: admin@example.com / changeme (ZMEN!)
```

### plex (`32400`)

Media server.

```bash
cd plex
docker compose up -d
# Otevri http://<server-ip>:32400/web
```

### portainer (`9000`, `9443`)

Docker UI.

```bash
cd portainer
docker compose up -d
# Otevri http://<server-ip>: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://<server-ip>: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 <sluzba>
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 <sluzba>
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

---

**Poslední update:** 2026-08-01