Konradodocs

Uninstall the Konrado plugin

Remove the Konrado plugin from a server, then remove the server from Konrado.

This page removes the Konrado plugin from a server and the server from Konrado. It takes about 5 minutes. Once the plugin is gone, Konrado stops reading that server.

Before you start

  • Root SSH access to the server.
  • No support work that still needs this server's data.

Uninstall with one command

Log in to the server as root and run:

bash /opt/KonradoAi/scripts/uninstall.sh

The script stops and disables both services, removes their unit files, deletes /opt/KonradoAi, removes the plugin's sockets, and deletes the konrado.ai user and group. To keep the user and group, run it as KEEP_USER=true bash /opt/KonradoAi/scripts/uninstall.sh. It ends with:

Konrado.AI local integration files have been removed.
Delete the dashboard Integrations entry manually to finish the uninstall.

Then remove the server from Konrado.

Uninstall by hand

Use these steps when uninstall.sh is not on the server.

Stop and disable the services

systemctl stop konrado-server konrado-root
systemctl disable konrado-server konrado-root

Remove the service files

rm /etc/systemd/system/konrado-server.service /etc/systemd/system/konrado-root.service
systemctl daemon-reload

systemctl status konrado-server konrado-root now reports that both units could not be found.

Remove the files

rm -rf /opt/KonradoAi/
rm -rf /var/run/konrado-ai/
rm -f /var/run/konrado.ai.sock

Remove the user

userdel konrado.ai
groupdel konrado.ai

If the user or group is already gone, the command says so. That is fine.

Remove the server from Konrado

Open Workspace SettingsIntegrations, open the server's row menu (three dots) and choose Delete, then confirm. To keep the row and its history instead, choose Disconnect.

Check it works

The server is gone from the Integrations page, or reads Disconnected. On the server, systemctl status konrado-server konrado-root reports that both units could not be found, and /opt/KonradoAi no longer exists.

Last updated on

On this page