Skip to main content

Uninstall the agent

Removing the agent is a manual, deliberate process. There is no automated uninstaller. Run these steps as root.

Step 1: Stop and disable the service

sudo systemctl stop atherops-otel-agent
sudo systemctl disable atherops-otel-agent

Step 2: Remove the systemd unit

sudo rm -f /etc/systemd/system/atherops-otel-agent.service
sudo systemctl daemon-reload

Step 3: Remove binaries and data

sudo rm -f /usr/local/bin/atherops-otel-agent
sudo rm -rf /var/lib/atherops # collector binaries
sudo rm -rf /var/run/atherops # generated otelcol config / runtime
sudo rm -rf /etc/atherops # config + credentials

:::warning Removing /etc/atherops/credentials.json de-registers the host's key locally After you delete credentials.json, this host can no longer authenticate with its old key. To bring the host back later you must re-register it with a new install token. The host's record may remain on the Hosts page; remove it there if you want it gone from the UI. :::

Step 4: Confirm

systemctl status atherops-otel-agent

You should see Unit atherops-otel-agent.service could not be found.

See also