Den Agent von einem Gerät entfernen
Deinstalliere den octoja Agent unter Windows, macOS und Linux — und erfahre, was das Löschen eines Geräts aus dem octoja-Inventar auf dem Gerät selbst bewirkt.
Diese Anleitung zeigt dir, wie du den octoja Agent von einem Windows-, macOS- oder Linux-Gerät entfernst — und was dabei in octoja passiert. Es gibt zwei Wege: Du löschst das Gerät in octoja und der Agent entfernt sich selbst, oder du deinstallierst den Agent lokal auf dem Gerät.
Deinstalliert das Löschen eines Geräts auch den Agent?
Ja. Wenn du ein Gerät aus dem octoja-Inventar löschst, deinstalliert sich der Agent auf diesem Gerät selbst:
Der Umkehrschluss ist genauso wichtig: Weil das Löschen eines Geräts auch seinen Agent deinstalliert, lösche einen Geräteeintrag nie nur zum Aufräumen deiner Liste, solange der Agent auf dem Gerät weiterlaufen soll.
Welchen Weg solltest du wählen?
- Das Gerät wird noch verwaltet und ist erreichbar: Lösche es in octoja. Ein Schritt entfernt sowohl den Inventar-Eintrag als auch den Agent — du musst vorher nicht deinstallieren.
- Das Gerät ist bereits neu aufgesetzt oder weg: Lösche den Eintrag in octoja. Mehr ist nicht nötig.
- Das Gerät bleibt im Einsatz, aber ohne octoja: Deinstalliere den Agent lokal (unten) und lösche den Geräteeintrag, sobald er als offline angezeigt wird.
Das Gerät in octoja löschen
- Gehe in octoja zu Geräte und öffne das Gerät.
- Öffne das …-Menü oben rechts auf der Geräteseite und wähle Gerät löschen. Du brauchst die Berechtigung Gerät löschen, um diese Aktion zu sehen.
- Bestätige mit Löschen. octoja warnt dich vorher — das Löschen kann nicht rückgängig gemacht werden.
Das Gerät verschwindet aus der Liste unter Geräte, und der Agent auf dem Gerät entfernt sich selbst wie oben beschrieben.
Mehrere Geräte auf einmal löschen
- Gehe zu Geräte, öffne das …-Menü der Tabelle und schalte Mehrfachauswahl ein. Die Kontrollkästchen in den Zeilen erscheinen erst dann.
- Hake jedes Gerät an, das du entfernen willst.
- Öffne in der Auswahlleiste Weitere Aktionen und wähle Löschen.
- Tippe
LÖSCHENein und bestätige mit Geräte löschen.
Jedes Gerät wird genau wie im Einzelgerät-Ablauf entfernt, und jeder Agent deinstalliert sich wie oben beschrieben selbst. Geräte, für die dir die Berechtigung Gerät löschen fehlt, werden übersprungen — der Bestätigungsdialog nennt dir die Anzahl.
Manuell deinstallieren unter Windows
- Öffne auf dem Gerät Einstellungen → Apps → Installierte Apps.
- Suche octoja Agent (Herausgeber: octoja GmbH) und wähle Deinstallieren.
Die Deinstallation stoppt und entfernt beide Agent-Dienste (Octoja Agent und Octoja Launcher) und löscht die Programmdateien sowie die Verbindungseinstellungen.
Kein Eintrag für octoja Agent in der Liste? Auf dem Gerät ist möglicherweise Lokale Deinstallation verhindern aktiviert. Diese Einstellung ist standardmäßig aus; solange sie an ist, blendet der Agent seinen Eintrag aus „Programme und Features“ aus, damit ihn niemand mit einem Klick deinstallieren kann. Das ist eine Abschreckung, keine harte Sperre: Das Löschen des Geräts in octoja deinstalliert den Agent weiterhin, und der Befehl msiexec /x unten funktioniert nach wie vor. Um den Eintrag zurückzuholen, öffne das Gerät in octoja, wähle im …-Menü Agent-Einstellungen und schalte Lokale Deinstallation verhindern aus — oder deaktiviere die Einstellung in dem Konfigurationspaket, das sie aktiviert. Die Einstellung wirkt nur unter Windows; unter macOS und Linux bewirkt sie nichts.
Für eine unbeaufsichtigte Entfernung — zum Beispiel über deine Software-Verteilung — nutze die MSI-Datei, mit der du installiert hast:
msiexec /x octoja.Launcher.<version>.<arch>.msi /qn
Was zurückbleibt: Die Deinstallation löscht die Verbindungseinstellungen unter C:\ProgramData\octoja GmbH und entfernt den Ordner, sobald er leer ist. Hast du mit dem Setup-Skript installiert, bleibt dessen install.log darin liegen — lösche den Ordner dann von Hand, wenn du ein vollständig sauberes Gerät möchtest.
Die Geräte-Identität liegt nicht in diesem Ordner. Unter Windows speichert der Agent sie in der Registry unter HKEY_LOCAL_MACHINE\SOFTWARE\Octo\Launcher, wo sie die Deinstallation übersteht: Installierst du den Agent auf diesem Gerät erneut, registriert er sich mit derselben Identität — das Gerät taucht also wieder als dasselbe Gerät in octoja auf und nicht als zweiter Eintrag.
Manuell deinstallieren unter macOS
Der Agent bringt sein eigenes Deinstallations-Skript mit. Öffne Terminal (Programme → Dienstprogramme → Terminal) und führe aus:
sudo /opt/octoja/uninstall.sh
Das Skript stoppt beide Agent-Dienste (com.octoja.launcher und com.octoja.agent), entfernt ihre Einträge aus /Library/LaunchDaemons, löscht den kompletten Ordner /opt/octoja und entfernt die macOS-Paketquittung. Der Agent hält alle seine Dateien, Einstellungen und Logs unter /opt/octoja — es bleibt also nichts zurück, das ist die vollständige Entfernung.
Manuell deinstallieren unter Linux
Der Agent ist als Paket octoja installiert. Entferne ihn über den Paketmanager:
sudo apt purge octoja
Die beiden Dienste (octoja-launcher und octoja-agent) werden beim Entfernen automatisch gestoppt und deaktiviert. Beachte den Unterschied zwischen den beiden Paketmanager-Befehlen:
Wenn du direkt mit dpkg arbeitest, ist sudo dpkg -P octoja das Gegenstück zum Purge-Befehl.
Danach in octoja
Hast du das Gerät in octoja gelöscht, bist du fertig — der Eintrag ist aus deiner Liste verschwunden und das Löschen lässt sich nicht rückgängig machen.
Hast du den Agent stattdessen lokal deinstalliert, bleibt der Geräteeintrag in octoja bestehen: Er wechselt kurz darauf auf offline und liefert keine Daten mehr. Lösche den Eintrag über die Geräteseite (siehe oben), wann immer du bereit bist. Lässt du ihn stehen, bleibt er ein Offline-Gerät in deiner Liste.
Um ein Gerät später wieder aufzunehmen, installiere den Agent erneut über den normalen Bereitstellungsweg — siehe die Anleitungen unten.