Zum Inhalt

Deinstallation

Diese Seite beschreibt, wie du Vesana restlos und sauber entfernst — vom einzelnen Agenten bis zur kompletten Server-Instanz. Wähle den Abschnitt, der zu dir passt; die Schritte sind unabhängig voneinander.

Saubere Reihenfolge: erst abmelden, dann deinstallieren

Willst du nur einzelne Agenten/Collectoren loswerden (nicht die ganze Instanz), lösche das Gerät bzw. den Collector zuerst in der Vesana-Oberfläche (Host bzw. Collector → Löschen). Beim nächsten Kontakt weist der Server den Agenten/Collector an, sich abzumelden (Deregister) — er stoppt von selbst und hinterlässt keinen „Geister-Host". Erst danach das Binary wie unten entfernen. Entfernst du dagegen die komplette Instanz, ist die Reihenfolge egal.

Vesana-Server-Instanz entfernen

Die Instanz läuft als Docker-Compose-Stack unter /opt/vesana (Standard). Ein Befehl stoppt alle Container und entfernt Volumes (Datenbank, Redis, Uploads …), Images und verwaiste Container:

cd /opt/vesana
docker compose -f docker-compose.prod.yml down -v --rmi all --remove-orphans

-v löscht ALLE Daten unwiderruflich

Das Flag -v entfernt die Volumes — die komplette Monitoring-Datenbank, alle Verläufe, Konfigurationen und Backups im Volume sind danach weg. Willst du vorher sichern, lade dir zuerst über Admin → Wartung → Backup ein Voll-Backup herunter (siehe Backup & Disaster-Recovery). Ohne -v bleiben die Volumes erhalten.

Danach das Installationsverzeichnis löschen:

rm -rf /opt/vesana

Prüfen, ob wirklich nichts übrig ist:

docker ps -a | grep -i vesana        # sollte leer sein
docker volume ls | grep -i vesana    # sollte leer sein
docker images | grep -i vesana       # sollte leer sein

Aktiver Collector auf dem Server?

Hast du den Aktiven Collector direkt auf dem Server-Host installiert (systemd-Dienst, nicht im Container), entferne ihn zusätzlich wie im Abschnitt Aktiven Collector entfernen beschrieben.

Weitere mögliche Spuren

  • System-nginx (Bare-Metal-Setups): Hast du einen eigenen nginx als Reverse-Proxy vor Vesana gesetzt, entferne die Vesana-Site aus /etc/nginx/sites-enabled/ und lade nginx neu (nginx -s reload).
  • Let’s-Encrypt-Zertifikat: Optional certbot delete --cert-name <deine-domain>.
  • Cron/Timer: Es werden keine systemweiten Cronjobs angelegt; nichts zu tun.

Agent entfernen

Der Agent läuft als systemd-Dienst vesana-agent. Deinstallation:

# Dienst stoppen und dauerhaft deaktivieren
sudo systemctl disable --now vesana-agent

# Unit-Datei, Binary, Konfiguration, Logs und Zustand entfernen
sudo rm -f  /etc/systemd/system/vesana-agent.service
sudo rm -f  /usr/local/bin/vesana-agent
sudo rm -rf /etc/vesana-agent
sudo rm -rf /var/log/vesana-agent
sudo rm -rf /var/lib/vesana-agent

# systemd neu einlesen
sudo systemctl daemon-reload
sudo systemctl reset-failed vesana-agent 2>/dev/null || true

Prüfen: systemctl status vesana-agent sollte „Unit vesana-agent.service could not be found" melden.

Ein zweiter Agent heißt vesana-agent-<name> — dieselben Schritte mit dem Suffix an Dienst, Binary und Verzeichnissen.

Der Agent läuft als Windows-Dienst VesanaAgent und ist als reguläres Programm registriert.

Empfohlen (grafisch): Einstellungen → Apps → Installierte Apps → „Vesana Agent" → Deinstallieren. Der mitgelieferte Uninstaller stoppt den Dienst, entfernt das Programm und den Registry-Eintrag.

Alternativ (PowerShell als Administrator):

# Uninstaller des NSIS-Setups aufrufen (Standard-Installationspfad)
& "$env:ProgramFiles\Vesana Agent\uninstall.exe" /S

# Falls der Dienst wider Erwarten bleibt, hart entfernen:
Stop-Service VesanaAgent -ErrorAction SilentlyContinue
sc.exe delete VesanaAgent

Konfiguration ebenfalls entfernen (optional):

Remove-Item -Recurse -Force "$env:ProgramData\Vesana\Agent" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:APPDATA\Vesana\Agent"     -ErrorAction SilentlyContinue

Collector entfernen

Der Collector läuft als systemd-Dienst vesana-collector.

# Dienst stoppen und deaktivieren
sudo systemctl disable --now vesana-collector

# Unit-Datei, Binary, Konfiguration und Plugins entfernen
sudo rm -f  /etc/systemd/system/vesana-collector.service
sudo rm -f  /usr/local/bin/vesana-collector
sudo rm -rf /etc/vesana
sudo rm -rf /opt/vesana-collector

sudo systemctl daemon-reload
sudo systemctl reset-failed vesana-collector 2>/dev/null || true

nmap

Der Collector-Installer richtet für die Netzwerk-Discovery nmap ein. Falls du es nur für Vesana installiert hattest und nicht mehr brauchst: sudo apt-get remove --purge nmap (bzw. das Kommando deines Paketmanagers).

Aktiven Collector entfernen

Der Aktive Collector läuft als eigener systemd-Dienst vesana-active-collector unter dem System-Benutzer vesana-ac.

# Dienst stoppen und deaktivieren
sudo systemctl disable --now vesana-active-collector

# Unit-Datei, Binary, Konfiguration und Zustand entfernen
sudo rm -f  /etc/systemd/system/vesana-active-collector.service
sudo rm -f  /usr/local/bin/vesana-active-collector
sudo rm -rf /etc/vesana-active-collector
sudo rm -rf /var/lib/vesana-active-collector

sudo systemctl daemon-reload
sudo systemctl reset-failed vesana-active-collector 2>/dev/null || true

# System-Benutzer entfernen (optional)
sudo userdel vesana-ac 2>/dev/null || true

Danach

  • Geräte in Vesana aufräumen: Falls du Agenten/Collectoren entfernt hast, ohne sie vorher in der Oberfläche zu löschen, erscheinen sie eine Weile als „offline" bzw. „No Data". Lösche die betreffenden Hosts/Collectoren in der Vesana-Oberfläche.
  • Lizenz/Tester-Modus: Es gibt keinen Aktivierungsserver, der abgemeldet werden müsste — mit dem Entfernen der Instanz ist alles erledigt.