Häufige Fragen (FAQ)

Häufige Fragen (FAQ)

Was ist Fleet Manager und wofür brauche ich es?

Fleet Manager ist ein Claude-Code-Plugin, mit dem du mehrere Linux-Server über SSH aus einer einzigen Session verwaltest. Statt SSH-Verbindungen manuell zu jonglieren, pflegst du ein Inventar, setzt einen aktiven Server und nutzt klare Befehle für Status, Docker, Logs, Datei-Transfer und einen flottenweiten Health-Überblick.

Was kostet Fleet Manager?

Nichts. Fleet Manager ist Open Source unter der MIT-Lizenz und vollständig kostenlos. Es läuft lokal in deinem Claude Code — es gibt keinen Cloud-Dienst und keine Abo-Gebühren.

Die erste Verbindung zu einem Server schlägt fehl — woran liegt das?

Meist fehlt der Host-Schlüssel in deiner ~/.ssh/known_hosts. Fleet Manager arbeitet mit BatchMode=yes und vertraut unbekannten Hosts nicht automatisch — die erste Verbindung scheitert daher bewusst. Hinterlege den Schlüssel einmalig nach Prüfung des Fingerprints: ssh-keyscan -p <port> <host> >> ~/.ssh/known_hosts, dann erneut /setup-ssh bzw. /diag.

Worin unterscheiden sich /copy und /sync?

/copy kopiert einmalig eine Datei oder ein Verzeichnis (rsync, mit scp-Fallback). /sync spiegelt ein Verzeichnis (rsync) und ist standardmäßig ein Trockenlauf — ideal, um wiederkehrende Backups oder Deployments abzugleichen.

Warum ist /sync standardmäßig nur ein Trockenlauf?

Als Schutz vor versehentlichen Massenänderungen. Ohne --apply zeigt /sync nur, was sich ändern würde. Erst mit --apply wird übertragen, und --delete (Entfernen von Ziel-Dateien) verlangt zusätzlich das Token --confirm-delete=<server>.

Wie schütze ich kritische Compose-Stacks vor versehentlichem Stoppen?

Trage die Projektnamen im Server-Profil unter critical_compose_projects ein. /compose-down und /compose-update verlangen dann das Token --confirm=<project>, bevor sie etwas an diesen Stacks tun.

Mein Docker läuft nur mit sudo — funktioniert das trotzdem?

Ja. /diag probiert automatisch mehrere Aufrufe (u. a. sudo -n docker) und speichert den passenden als docker_cmd. Voraussetzung ist ein passwortloser sudoers-Eintrag, z. B. user ALL=(ALL) NOPASSWD: /usr/bin/docker.

Landen meine Server-Daten (IPs, Benutzer, Schlüssel) in Git?

Nein. Reale Profile, der aktive Server und das Inventar (context/servers/*.md, context/active-server, context/inventory.md) sind git-ignoriert. Nur Vorlagen liegen im Repository — deine Topologie verlässt deinen Rechner nicht.

Brauche ich Root-Rechte?

Nein. Fleet Manager verbindet sich mit dem SSH-Benutzer, den du angibst. Privilegierte Aktionen auf dem Server regelst du dort über Gruppen-Mitgliedschaft (z. B. docker) oder passwortloses sudo — nicht über Root-Zugang vom Plugin.

Kann ich mehrere Server gleichzeitig steuern?

Fleet Manager arbeitet pro Befehl mit genau einem Server. /health-summary geht sequenziell durch die ganze Flotte (eine Zeile pro Server). Ein paralleles Ausrollen über viele Hosts wie bei Ansible ist nicht der Anwendungsfall.

Wie wechsle ich den aktiven Server?

Mit /use <name> setzt du den aktiven Server dauerhaft. Für einen einmaligen Befehl gibst du den Server einfach als Argument mit, z. B. /status vps-web — das überschreibt den aktiven Server nur für diesen Aufruf.

Wie tausche ich den SSH-Schlüssel aus?

Lösche ~/.ssh/fleet-manager_ed25519 samt .pub und führe /setup-ssh erneut aus. Der Befehl ist idempotent und erzeugt bei Bedarf einen neuen Schlüssel, den du dann wie gewohnt deployst.

Worin unterscheidet sich Fleet Manager von synology-manager-plus?

synology-manager-plus ist auf Synology-NAS (DSM, RAID, SMART) spezialisiert. Fleet Manager ist das generische Pendant für beliebige Linux-Hosts — VPS, Homelab-Server, App-Maschinen. Beide lassen sich parallel nutzen.