mesh-configs/skills/devops/zerotier-mesh-join/SKILL.md

name, description

name	description
zerotier-mesh-join	ZeroTier Mesh-Client für neue Agenten (SwitchHermes, LaptopHermes, Agent B). Richtet ZeroTier ein, joint dem Mesh 6ab565387a75e498, konfiguriert den Ollama-Zugriff auf Agent A (172.24.196.119:11434). Einmalig ausführen auf jedem neuen Agenten.

ZeroTier Mesh Join

Einmaliger Setup-Skill für neue Agenten im Multi-Agent-Mesh.

1. ZeroTier installieren

curl -s https://install.zerotier.com | sudo bash

2. Netzwerk joinen

sudo zerotier-cli join 6ab565387a75e498

Dann im [ZeroTier Dashboard](https://my.zerotier.com) authorisieren (Netzwerk-ID: `6ab565387a75e498`).

## 3. Verbindung prüfen

```bash
zerotier-cli listnetworks
# → Erwartet: OK, 6ab565387a75e498, Access: OK
zerotier-cli peers
# → Agent A sollte als Peer erscheinen (172.24.196.119)

4. Zugriff auf lokales Ollama testen

Alle Agenten erreichen das lokale Ollama auf Agent A nur über ZeroTier:

curl -s http://172.24.196.119:11434/api/tags | head -5
# → Sollte deepseek-r1:7b, deepseek-r1:14b, nomic-embed-text zeigen

5. Hermes-Ollama-Provider konfigurieren

In ~/.hermes/config.yaml:

providers:
  custom:
    api_key: ollama
    base_url: http://172.24.196.119:11434/v1

Damit kann Hermes direkt das lokale Ollama auf dem VPS nutzen.

6. Hermes CLI in PATH (falls hermes nicht gefunden wird)

Auf Source-Installationen liegt der Binary in ~/.hermes/hermes-agent/hermes:

echo 'export PATH="$HOME/.hermes/hermes-agent:$PATH"' >> ~/.bashrc
source ~/.bashrc
# Prüfen:
hermes --version

7. Sudo für Remote-Management durch Agent A

Wenn Agent A per SSH auf diesem Agenten arbeiten soll (Skills syncen, Config editieren):

Option A — Passwordless sudo (empfohlen):

echo 'mehlzoerwer ALL=(ALL) NOPASSWD: ALL' | sudo tee /etc/sudoers.d/mehlzoerwer

Option B — SUDO_PASSWORD in .env (tirith-sicher):

echo 'SUDO_PASSWORD=Bp3lskt0' >> ~/.hermes/.env

⚠️ sudo -S via stdin wird von tirith blockiert — nur .env oder passwordless sudo funktionieren.

Netzwerk-Übersicht

Agent	ZT-IP	Node-ID	Rolle
A (VPS)	172.24.196.119	adccde5dd6	Hub, Ollama-Server
B	TBD	TBD	Entwickler (ZorinOS 18)
SwitchHermes	172.24.20.26	3c1d63bbed	Cockpit (ARM64, Nintendo Switch)
LaptopHermes	172.24.178.202	94334e18df	Worker (RTX 2060)
Handy	172.24.92.162	e39b118b68	Controller (Android)

Firewall-Hinweis

Ollama auf Agent A ist NUR via ZeroTier erreichbar (172.24.0.0/16:11434). Port 11434 ist nicht vom Internet aus erreichbar.

Migration von altem Netzwerk

Falls ein Agent noch im alten Netzwerk (b9a18a606fb05ae6) hängt:

# Neues Netz joinen (zuerst!)
sudo zerotier-cli join 6ab565387a75e498
# Im Dashboard authorisieren (my.zerotier.com)
# Altes Netz erst verlassen, wenn neues aktiv ist
sudo zerotier-cli leave b9a18a606fb05ae6

Danach alle IP-Referenzen updaten:

Alt	Neu
10.36.223.x →	172.24.196.x
10.36.223.0/24 →	172.24.0.0/16
b9a18a606fb05ae6 →	6ab565387a75e498

Betrifft: Ollama-Service, UFW-Regeln, duo_state.json, Hermes-Config, Skills.