Uninstall Agent

How to completely remove the HelmRelay agent from your server.

Uninstall steps

Follow these steps to completely remove the agent:

Step 1 — Stop and disable the service

sudo systemctl stop helmrelay-agent
sudo systemctl disable helmrelay-agent

Step 2 — Remove the systemd service file

sudo rm /etc/systemd/system/helmrelay-agent.service
sudo systemctl daemon-reload

Step 3 — Delete the agent binary

sudo rm /usr/local/bin/helmrelay-agent

Step 4 — Remove configuration and data files

sudo rm -rf /etc/helmrelay/
sudo rm -rf /var/lib/helmrelay/
sudo rm -rf /var/log/helmrelay/

Step 5 — Clean up journal logs (optional)

sudo journalctl --rotate
sudo journalctl --vacuum-time=1s -u helmrelay-agent

Verify removal

Confirm the agent is completely removed:

# Should return "not found"
which helmrelay-agent

# Should return "could not be found"
systemctl status helmrelay-agent

# Should return nothing
ls /etc/helmrelay/ 2>/dev/null && echo "Config still exists" || echo "Clean"

Remove server from dashboard

After uninstalling the agent, the server will appear as "Disconnected" in your dashboard. To remove it completely:

1. Go to Dashboard → Servers
2. Click on the disconnected server
3. Go to Server Settings
4. Click Delete Server
5. Confirm deletion

This permanently removes the server and all associated data (metrics, logs, sessions) from HelmRelay.

Reinstalling

Want to reconnect this server? You can reinstall the agent at any time:

$ curl -sSL https://cdn.helmrelay.com/install.sh | sudo bash -s -- --token YOUR_TOKEN --server-id YOUR_SERVER_ID

You'll need a new connection token from the dashboard.

See also

• Agent overview
• Installation guide
• Troubleshooting