diff --git a/README.md b/README.md
index 56ebf3a..4c42137 100644
--- a/README.md
+++ b/README.md
@@ -1,23 +1,158 @@
 # mates-home-nas-tools
 
-**Metadata** k projektům uloženým na NAS.
-Toto repo **neobsahuje archivy**, pouze jejich popis, cestu na NAS a velikost.
+Metadata k projektům uloženým na **NAS** (Network Attached Storage).
+Toto repo obsahuje **pouze popisy a cesty** – samotné archivy zůstávají na NAS.
 
-## Cesta k archivům (NAS)
+> **Proč to tu je?** Aby ses při práci na novém stroji nebo při obnově po havárii **věděl, co kde je** a jak to znovu nasadit.
 
-Všechny archivy jsou uloženy na:
+---
+
+## 📍 Kde jsou archivy
+
+Všechny archivy jsou uloženy na NAS:
 
 ```
-<nas-projects-root>/
+/Volumes/Backups/Prace/moje-tools/
 ```
 
-Tato cesta je specifická pro tvůj Mac s připojeným NAS (SMB).
-Na novém stroji musíš připojit NAS nebo zkopírovat archivy ručně.
+Tato cesta je specifická pro **tvůj Mac** s připojeným NAS přes SMB. Na novém stroji musíš:
 
-## Detailní návod
+1. Připojit NAS (`mount -t smbfs` nebo Finder → Go → Connect to Server)
+2. Nebo zkopírovat archivy ručně (rsync, scp, USB disk)
 
-Viz [README.md](README.md) – co je tu zahrnuto, jak použít, bezpečnost.
+---
 
-## Licence
+## 📂 Co tu je
+
+```
+mates-home-nas-tools/
+├── README.md                    # Tento soubor
+└── (žádné další soubory – archivy zůstávají na NAS)
+```
+
+**Proč tak málo souborů?** Toto repo je **pouze index**. Skutečné archivy (`.zip`, `.7z`, `.tar.gz`) zůstávají na NAS, **ne v gitu**. Git není vhodný pro velké binární soubory.
+
+---
+
+## 🚀 Jak použít
+
+### 1. Připoj NAS
+
+**macOS:**
+```bash
+# Finder → Go → Connect to Server (⌘K)
+# Zadej: smb://<nas-ip>/Backups
+# nebo v terminalu:
+mount -t smbfs //<user>@<nas-ip>/Backups/Prace /Volumes/nas-tools
+```
+
+**Linux:**
+```bash
+sudo mount -t cifs //<nas-ip>/Backups/Prace/moje-tools /mnt/nas-tools \
+    -o username=<user>,password=<password>
+```
+
+### 2. Podívej se, co je k dispozici
+
+```bash
+ls -la /Volumes/Backups/Prace/moje-tools/
+```
+
+Uvidíš seznam `.zip`, `.7z`, `.tar.gz` archivů.
+
+### 3. Rozbal co potřebuješ
+
+```bash
+cd /Volumes/Backups/Prace/moje-tools/
+
+# Standardní zip
+unzip <nazev-projektu>.zip
+
+# 7-zip (vyžaduje: brew install p7zip)
+7z x <nazev-projektu>.7z
+
+# tar.gz
+tar -xzf <nazev-projektu>.tar.gz
+```
+
+### 4. Nasaď podle README uvnitř
+
+Každý archiv obsahuje vlastní `README.md` nebo `INSTALL.md` s konkrétním postupem.
+
+---
+
+## 🔐 Bezpečnost
+
+| Aspekt | Jak řešen |
+|---|---|
+| Citlivá data (hesla, forenzní dumpy) | **NEJSOU v gitu** – archivy na NAS |
+| Hesla k archivům | **V keychainu** na tvém Macu |
+| Přístup na NAS | **SMB s heslem** (ne anonymous) |
+| Šifrování archivů | Některé `.7z` jsou šifrované heslem |
+| Sdílení s kolegy | **Vytvoř zvláštní verzi README** (bez konkrétních cest/názvů) |
+
+### ⚠️ Doporučení
+
+- **Nepushuj archivy do Gitea** – git na to není stavěný
+- **Nesdílej toto repo veřejně** – obsahuje popis citlivých projektů
+- **Pravidelně zálohuj NAS** – off-site backup (Backblaze B2, jíný disk, …)
+
+---
+
+## 🛠 Doporučený workflow
+
+```
+Mac (~/Skripty/)    Pracovní kopie
+       |
+       | rsync (denne)
+       |
+NAS (moje-tools/)   Centralní záloha
+       |
+       | off-site backup
+       |
+Cloud (S3/Backblaze) Disaster recovery
+```
+
+---
+
+## 🏗 Struktura NAS archivu
+
+```
+/Volumes/Backups/Prace/moje-tools/
+├── forenzika/
+│   ├── asistent-v1.zip
+│   ├── pipeline.zip
+│   └── ...
+├── utility/
+│   ├── bitcopy-backup.tar.gz
+│   ├── whois.zip
+│   └── ...
+├── konverze/
+│   ├── json2xml.zip
+│   └── ...
+├── ai-asistenti/
+│   ├── docker-verze.7z
+│   ├── portable.zip
+│   └── ...
+└── (atd.)
+```
+
+*(Tato struktura se může v průběhu času měnit – archivy jsou přidávány a odebírány podle potřeby.)*
+
+---
+
+## 📚 Související
+
+- **Jotty:** knowledge base (detailní informace o projektech)
+- **mates-ansible:** Ansible pro nový server
+- **mates-install-scripts:** Docker zálohy na NAS (`dk-backup`)
+
+---
+
+## 📜 Licence
 
 MIT – viz [LICENSE](LICENSE)
+
+---
+
+**Poslední update:** 2026-08-01