Den poison0-Agenten auf Linux installieren
Den poison0-Agenten auf Linux installieren, ausrollen, prüfen und entfernen.
Voraussetzungen
| Voraussetzung | Details |
|---|---|
| Prozessor | x86-64 mit AVX2 (Intel Haswell, 2013, oder neuer, AMD Zen oder neuer), oder ARM64 mit i8mm, zum Beispiel AWS Graviton 3 oder 4 und Ampere One. AWS Graviton 2 und Ampere Altra werden nicht unterstützt. |
| Kernel | Kernel 5.13 oder neuer mit aktivem Landlock, wie bei Ubuntu 22.04, Debian 12 und RHEL 9.6 oder neuer. Sonst ergänzen Sie landlock im Boot-Parameter lsm=. |
| Container | Das Standard-seccomp-Profil von Docker blockiert die Landlock-Systemaufrufe. Nutzen Sie ein angepasstes Profil. |
| Rechte | root-Rechte. Der Installer läuft über sudo. |
| Installationsschlüssel | Ein Installationsschlüssel aus der Konsole, unter Geräte → Mehrere Geräte per Schlüssel. |
| KI-Agenten | Mindestens ein KI-Agent aus Unterstützte Agenten. |
Einen Rechner installieren
Führen Sie diesen Befehl in einem Terminal aus.
curl -fsSL https://poisonzero.com/install.sh | sudo PZ_ENROLL_CODE="<install-key>" sh
Der Installer prüft das Programm gegen SHA256SUMS und bricht bei einer Abweichung ab. Dann installiert er den Dienst und registriert den Rechner. Fehlt dem Desktop ein Dialogprogramm für Bestätigungsdialoge, versucht er zenity zu installieren. In einem Terminal fragt er zusätzlich, ob er den Gerätenamen an die Konsole senden soll. Sie antworten mit Ja oder Nein, eine Vorgabe gibt es nicht. Ja sendet den Hostnamen des Rechners, Nein sendet keinen Namen. Bei Ansible und in Skripten ohne Terminal fragt er nicht und sendet keinen Namen.
Die Standardwerte ändern Sie mit den Umgebungsvariablen unter Referenz.
Rechner prüfen
- Führen Sie
systemctl status poisonzeroaus. Der Dienst sollte aktiv sein.journalctl -u poisonzerozeigt sein Log. - Führen Sie
poison0 doctorin Ihrer Desktop-Sitzung aus. Der Befehl nennt, was nicht stimmt. - Öffnen Sie die Konsole. Der Rechner steht unter Geräte.
poison0 ist auch als p0 und pz aufrufbar. Nutzt bereits ein anderes Programm einen dieser Namen, wird dieser Alias nicht angelegt.
Nach der ersten Installation lädt das Modell im Hintergrund. Die festen Regeln schützen sofort.
Auf viele Rechner ausrollen
Nutzen Sie Ansible oder ein anderes Skript, das als root läuft.
1. Den Agenten installieren
Ohne Terminal übergeben Sie den Schlüssel als Umgebungsvariable. Auf einem Server ohne Desktop setzen Sie zusätzlich PZ_HEADLESS.
PZ_ENROLL_CODE="<install-key>" sh -c "$(curl -fsSL https://poisonzero.com/install.sh)"
2. Optional: /pz und Statusline einrichten
Den Schutz für die KI-Agenten richtet PoisonZero nach der Installation selbst ein, in jedem Benutzerkonto und für alle unterstützten Agenten. Wer zusätzlich /pz und die Statusline möchte, führt diese Befehle einmal im Benutzerkonto aus. Der zweite trägt die Statusline ein.
poison0 setup-claude poison0 setup-claude --statusline-only
Intune (Linux)
Intune führt auf Ubuntu Desktop 24.04 und 26.04 sowie Red Hat Enterprise Linux 9 und 10 Bash-Skripts aus. Der Rechner muss in Intune angemeldet sein.
- Öffnen Sie in der Konsole Geräte, wählen Sie Intune-Paket herunterladen und dort Linux. Die Konsole lädt das Skript herunter.
- Legen Sie in Intune unter Geräte → Skripts und Wartungen → Plattformskripts → Hinzufügen → Linux ein Skript an und laden Sie die Datei hoch.
- Wählen Sie als Ausführungskontext Root. Die Häufigkeit ist beliebig, Intune führt das Skript standardmäßig alle 15 Minuten aus. Bei Wiederholungen bei Fehler tragen Sie zum Beispiel 3 ein.
- Weisen Sie das Skript einer Gerätegruppe zu.
Das Skript meldet einen Rechner, der schon registriert ist, kein zweites Mal an. Beim ersten Lauf kann Intune die Zustimmung des Benutzers verlangen. Das Skript enthält einen Installationsschlüssel, den alle Intune-Admins mit Leserecht auf Skripts sehen. Die Konsole listet ihn als Intune Linux mit dem Datum. Er gilt ein Jahr, widerrufen Sie ihn nach dem Rollout.
Private Rechner: signierte Konfiguration
Ein privater Rechner holt keine Einstellungen aus der Cloud. Er liest eine signierte client-config.json.
- Öffnen Sie in der Konsole das Profil und wählen Sie Für Private exportieren.
- Übergeben Sie die Datei mit
PZ_CONFIGan den Installer, wie unten gezeigt. - Oder legen Sie sie mit dem Ansible-Task ab, den die Konsole nach dem Export zeigt.
curl -fsSL https://poisonzero.com/install.sh | sudo \ PZ_ENROLL_CODE="<install-key>" PZ_CONFIG="./client-config.json" sh
Der Installer prüft die Datei mit poison0 config verify und legt sie unter /etc/poisonzero/client-config.json ab, lesbar nur für root.
Update
Cloud-Geräte aktualisieren sich selbst. Ausschalten können Sie das je Gerät in der Konsole unter Settings → Schutz & Geräte → Updates. Private Geräte aktualisieren sich nicht selbst.
Für ein Update von Hand führen Sie den Installationsbefehl erneut aus. Die Zugangsdaten bleiben erhalten. Mehr unter Updates und Lebenszyklus.
Ab dieser Version ist die Programmdatei /usr/local/bin/poison0. poisonzero verweist darauf und funktioniert weiter, Ordnerausschlüsse bleiben gültig. Für Datei- oder Prozessausschlüsse fügen Sie poison0 hinzu und behalten poisonzero, weil Agenten-Hooks es weiter aufrufen.
Deinstallieren
curl -fsSL https://poisonzero.com/install.sh | sudo sh -s -- --uninstall
Die Deinstallation entfernt zuerst die Agent-Hooks aller Nutzer und bricht ab, wenn das fehlschlägt. Danach entfernt sie den Dienst, das Programm für Bestätigungsdialoge, die Befehle, das Programm und das Datenverzeichnis.
Eine Installation per .deb oder .rpm entfernen Sie mit dem Paketmanager. Er nimmt zuerst die Hooks heraus.
sudo apt remove poisonzero # .deb sudo dnf remove poisonzero # .rpm
Offene Quarantänefälle
Die Deinstallation listet jeden offenen Quarantänefall mit Originalpfad, Quarantänekopie (*.infection.pz) und Weg zur Wiederherstellung. Eine Kopie bleibt in /var/lib/poisonzero-quarantine, lesbar nur für root.
Mit PZ_UNINSTALL_SKIP_QUARANTINE_COPY=1 entfällt diese Kopie. Nichts wird automatisch wiederhergestellt. Prüfen Sie jede Datei, bevor Sie sie wiederherstellen.
Zurückgehaltene Änderungen, die noch auf Prüfung warten, verwirft die Deinstallation. Um eine zu behalten, geben Sie sie vorher frei: Listen Sie sie mit poison0 quarantine pending auf und führen Sie poison0 quarantine pending approve <id> aus.
Fehlerbehebung
| Symptom | Ursache | Lösung |
|---|---|---|
| Die Engine startet nicht. | Landlock ist nicht aktiv. | Aktivieren Sie Landlock wie unter Voraussetzungen beschrieben. |
poison0 doctor zeigt, dass der Download des Modells fehlgeschlagen ist. | Der Download im Hintergrund nach der ersten Installation wurde nicht abgeschlossen. | Führen Sie sudo poison0 model aus, um es sofort erneut zu versuchen. poison0 doctor zeigt den Grund. |
poison0 exec0 status zeigt, dass Claude Code den exec0-Hook nicht aufruft. | Die Claude-Code-Einstellungen kommen aus der Admin-Konsole von claude.ai. Claude Code ignoriert dann 50-poisonzero-exec0.json. | Setzen Sie in dieser Quelle "managedSourcesBehavior": "merge" (Claude Code 2.1.242 oder neuer), oder kopieren Sie den Inhalt der Datei hinein. |
poison0 doctor meldet, dass die verwalteten Hooks aus sind. | Die verwalteten Einstellungen von Claude Code setzen "disableAllHooks": true. Das schaltet auch die verwalteten Hooks des Agenten aus. | Entfernen Sie die Einstellung dort, wo sie gesetzt ist: in managed-settings.json, einer anderen Datei in managed-settings.d/ oder der Admin-Konsole von claude.ai. Der Agent ändert diese Quellen nie. |
| Die Installation bricht nach der Registrierung ab, und die signierte Konfiguration wird nicht abgelegt. | poison0 config verify hat client-config.json abgelehnt. Eine vorhandene Datei bleibt. | Schlagen Sie den Exit-Code unter Referenz nach. |
| Die Deinstallation bricht ab und entfernt nichts. | Sie konnte die Agent-Hooks nicht bei allen Nutzern entfernen. | Setzen Sie PZ_UNINSTALL_FORCE=1 und entfernen Sie die restlichen Einträge von Hand. |
Referenz
Umgebungsvariablen
Setzen Sie die Variablen, bevor der Installer startet. Ein Flag, übergeben nach sh -s --, hat Vorrang vor seiner Variablen.
| Variable | Wirkung |
|---|---|
PZ_ENROLL_CODE | Der Installationsschlüssel aus der Konsole. Auf einem registrierten Rechner registriert ein neuer Schlüssel ihn erneut. |
PZ_APP_ID | Nur für einen Einmal-Code, der mit einer App-ID kam. |
PZ_HEADLESS | Wie Bestätigungsdialoge behandelt werden, wenn kein Desktop-Nutzer antworten kann. none (Standard) richtet sich nach dem angemeldeten Nutzer, standard behandelt den Rechner immer als Gerät ohne Desktop, strict ist am strengsten. Flag: --headless. |
PZ_DEVICE_NAME | Der Gerätename in der Konsole, gespeichert als Kleinbuchstaben, Ziffern und Bindestriche, höchstens 63 Zeichen. Der Installer zeigt, wie der Name gespeichert wird. Weitere Varianten beschreibt das Onboarding. |
PZ_SETUP_AGENTS | Trägt den lokalen Statistikbefehl /poison0 in die genannten Agenten ein, zum Beispiel claude,codex. |
PZ_SETUP_STATUSLINE | Auf 1 setzen, um die Statusline in Claude Code einzutragen. Eine vorhandene Statusline bleibt. |
PZ_SETUP_EXEC0 | Auf off setzen, damit exec0 aus bleibt, auch nach Updates. Andere Werte werden ignoriert. Eingeschaltet wird es im Konsolenprofil oder mit sudo poison0 exec0 observe bzw. enforce. |
PZ_SETUP_LEAK0 | Nur für private Geräte. Setzt den leak0-Modus: enforce, observe oder off. Ohne die Variable und ohne Terminal bleibt leak0 aus. |
PZ_BACKEND | cpu (Standard) oder gpu. Ob der Rechner die GPU nutzt, legt das Konsolenprofil fest. |
PZ_TIER | enterprise (Standard) oder ultra. Mit ultra bricht der Installer mit einem Fehler ab. Legen Sie Ultra deshalb im Konsolenprofil fest. |
PZ_NO_SHORT_ALIAS | Auf 1 setzen, um den Kurzbefehl p0 auszulassen. |
PZ_FETCH_ONLY | Auf 1 setzen, um das Programm nur herunterzuladen und zu prüfen, ohne Dienst und ohne root-Rechte. Es landet in ./poison0 oder in PZ_FETCH_DEST. |
PZ_DRY_RUN | Auf 1 setzen, um den Installationsmodus auszugeben und vor jeder Änderung zu beenden. |
POISONZERO_DATA_DIR | Ändert das Datenverzeichnis von Installer und Agent. |
PZ_CONFIG | Pfad zu einer signierten client-config.json für einen privaten Rechner. Flag: --config. |
PZ_QUARANTINE_RETENTION_DAYS | Nur für private Geräte. Tage, die ein Quarantänefall aufbewahrt wird, 1 bis 3650. Flag: --quarantine-retention-days. |
PZ_AUDIT_MAX_MB | Nur für private Geräte. Größe in MB, ab der das Audit-Log rotiert, 1 bis 1024. Flag: --audit-max-mb. |
Pfade und Dienst
| Element | Ort |
|---|---|
| Das Programm und seine Befehle. | /usr/local/bin/poison0. Die Befehle poisonzero, p0 und pz verweisen darauf. |
| Das Datenverzeichnis. | /var/lib/poisonzero, Eigentümer poisonzero:poisonzero. Es enthält die Zugangsdaten, die Logs und die Quarantäne. |
| Das Konfigurationsverzeichnis. | /etc/poisonzero. Es enthält die Registrierungsdatei /etc/poisonzero/enroll und die signierte Konfiguration. |
| Der Dienst. | Die systemd-Unit poisonzero.service. Sie startet beim Booten und läuft als root. |
| Das Programm für Bestätigungsdialoge. | Es startet in jeder Desktop-Sitzung über XDG-Autostart, /etc/xdg/autostart/poisonzero-notifier.desktop. |
| Das Dienst-Log. | daemon.log im Datenverzeichnis, rotiert bei 5 MB. Dieselben Zeilen gehen ins Journal. |
| Die exec0-Hooks für Claude Code. | Eine Systeminstallation (install.sh, .deb oder .rpm) nutzt die eigene Datei /etc/claude-code/managed-settings.d/50-poisonzero-exec0.json, auch unter WSL. Eine Homebrew-Installation unter einem Präfix des Nutzers nutzt stattdessen ~/.claude/settings.json. |
exec0-Hooks in Claude Code
Der Agent ändert nie Ihre managed-settings.json und keine anderen Dateien in managed-settings.d/. So schalten Sie exec0 für Claude Code aus oder ein:
# turn off sudo poison0 setup-claude --toolgate-off # turn on sudo poison0 setup-claude --toolgate
Exit-Codes der signierten Konfiguration
poison0 config verify gibt diese Codes zurück. Der Installer legt die Datei nur bei 0 oder 6 ab.
| Exit-Code | Bedeutung |
|---|---|
| 0 | Die Datei ist gültig. |
| 6 | Die Lizenz fehlt noch. Der Dienst prüft die Datei beim Start. |
| 1 | Die Datei ist nicht lesbar. |
| 3 | Die Datei ist nicht für dieses Gerät signiert. |
| 4 | Die Datei ist veraltet oder abgelaufen. |
| 5 | Die Datei ist ungültig oder zu neu für diese Agent-Version. |
| 7 | Der Rechner ist ein Cloud-Gerät, das die Datei ignoriert. |
Weiterlesen
Andere Betriebssysteme: Installationsüberblick. Hardware: Systemvoraussetzungen. Isolation der Engine: Linux-Sandbox.