Upgrade Plugin

When a new version of the Konrado.AI server plugin is available, the integration table shows a New version available badge.

Estimated time: 2-5 minutes. The restart can briefly interrupt server data availability in Konrado.AI.

Before You Start

A connected SSH-based server integration.
Root SSH access if you plan to upgrade manually.
A maintenance window if your team depends on live server context during support work.

What This Changes

The upgrade refreshes the Konrado.AI server agent files, data files, scripts, permissions, and services. It does not remove the integration from Konrado.AI.

Automatic Upgrade

In Konrado.AI, open Integrations, find the integration with New version available, click Upgrade, then choose Run Automatic Upgrade.

The status updates automatically when the remote upgrade finishes.

Automatic upgrade runs the update process remotely. No SSH access is needed for this path.

Manual Upgrade

bash /opt/KonradoAi/scripts/update.sh

The script downloads the latest plugin, updates files, sets permissions, and restarts both services.

Verify

Check that both services are running:

systemctl status konrado-server konrado-root

Expected result:

Active: active (running)

Then check the integration in Konrado.AI. It should show Connected.

Roll Back

If the upgrade fails, review the logs first:

journalctl -u konrado-server --since "10 minutes ago"
journalctl -u konrado-root --since "10 minutes ago"

If the service cannot be recovered, reinstall the agent from the integration modal or restore the server from your pre-upgrade backup or snapshot.

Troubleshooting

Issue	What to check
Automatic upgrade does not start	Confirm the integration is currently reachable and shows Connected
Manual script not found	Confirm the plugin is installed in `/opt/KonradoAi/`
Services fail after upgrade	Check `journalctl` for the first error and rerun the update script after fixing it
Dashboard shows disconnected	Wait for the service restart, then test the connection again