mates-infra/README.md

🏠 mates-infra – Home Infrastructure

Hlavní index pro home infrastructure as code projekty. Obsah je rozdělen do 6 specializovaných repozitářů pro snadnou orientaci a samostatné použití. Toto repo slouží jako orchestrátor + dokumentace.

---

📦 Repozitáře (6)

Repo	Obsah	URL
mates-docker-services	14 generických docker-compose.yml (portainer, npm, vaultwarden, gitea, jotty, nextcloud, …)	http://192.168.0.148:3000/mates/mates-docker-services
mates-ansible	4 Ansible playbooky (bootstrap, deploy, update, security)	http://192.168.0.148:3000/mates/mates-ansible
mates-install-scripts	Bash skripty pro nový Ubuntu server (bootstrap, docker, portainer, npm, backup, restore)	http://192.168.0.148:3000/mates/mates-install-scripts
mates-macos-setup	macOS workstation (Brewfile, Fish aliasy, osx defaults, Hermes CLI)	http://192.168.0.148:3000/mates/mates-macos-setup
mates-home-nas-tools	Rejstřík projektů na NAS (metadata only, žádné binárky)	http://192.168.0.148:3000/mates/mates-home-nas-tools
mates-docs	Architektura, bezpečnost, contributing	http://192.168.0.148:3000/mates/mates-docs

Proč 6 repo? Každý má jiný scope, jiný lifecycle, jiné uživatele. Např. mates-install-scripts se mění zřídka, mates-docker-services často.

🏗 Aktuální infrastruktura

┌─────────────────────────────────────────────────────────────┐
│  Nginx Proxy Manager (reverzní proxy + HTTPS)                │
└────────────────────┬────────────────────────────────────────┘
                     │
   ┌─────────────────┼─────────────────┬──────────────┐
   ▼                 ▼                 ▼              ▼
┌──────────┐   ┌──────────┐    ┌──────────┐    ┌──────────┐
│ Nextcloud│   │Vaultwarden│   │  Gitea   │    │  Jotty   │
│   AIO    │   │   :2999  │   │ :3000/222│    │   :1122  │
└──────────┘   └──────────┘    └──────────┘    └──────────┘
   … dalších 11 služeb (Plex, RustDesk, Audiobookshelf, …)

Detailní seznam: mates-docker-services/README.md

🚀 Rychlý start (nový server)

# 1. Klonuj všechna relevantní repo
git clone http://192.168.0.148:3000/mates/mates-install-scripts.git
git clone http://192.168.0.148:3000/mates/mates-docker-services.git

# 2. Bootstrap
cd mates-install-scripts
sudo bash bootstrap-ubuntu-server.sh
sudo bash install-docker.sh

# 3. Nasaď služby
cd ../mates-docker-services
cp portainer/.env.example portainer/.env  # a další služby
docker compose -f portainer/docker-compose.yml up -d
# ... atd.

# 4. (Volitelně) Ansible
git clone http://192.168.0.148:3000/mates/mates-ansible.git
cd mates-ansible
ansible-playbook -i inventory.example.yml playbooks/deploy-services.yml

📚 Dokumentace

• 🏛 Architektura – jak to celé funguje
• 🔐 Bezpečnost – hardening, secrets
• 🤝 Contributing – jak přispívat
• 📝 Jotty knowledge base – interní dokumentace

🗂 Mapa závislostí

mates-infra           (toto repo – index)
    ├──→ mates-docs           (architektura, bezpečnost)
    ├──→ mates-docker-services (služby)
    ├──→ mates-install-scripts (nový server)
    ├──→ mates-ansible        (idempotentní deploy)
    ├──→ mates-macos-setup    (workstation)
    └──→ mates-home-nas-tools (metadata k NAS)

🔒 Bezpečnost

• Všechna hesla v .env.example (šablona), nikdy v docker-compose.yml
• API token Gitea uložen v macOS keychainu (gitea:api:192.168.0.148)
• SSH klíče pro git push přes credential.helper
• HTTPS terminuje Nginx Proxy Manager (Let's Encrypt)
• Detailní security hardening: mates-docs/security.md

📜 Licence

MIT – používej jak chceš.

---

Home lab · 2026 · Poslední update: 2026-08-01