Control Panel Plugin

Use the Control Panel Plugin guide for cPanel, DirectAdmin, Plesk, and Proxmox servers. The setup is the same for each platform; only the --platform value changes.

Estimated time: 5 minutes

Before You Start

Access to Konrado.AI Integrations.
Root SSH access to the target server.
Outbound HTTPS access from the server to Konrado.AI.
If inbound panel/API access is restricted, allow the Konrado.AI static IP addresses.

What This Connects

Konrado.AI reads hosting account, domain, service, package, server, VPS, or host context depending on the selected platform.

Choose the Platform

In Konrado.AI, open Integrations > Applications, click Add Integration, and choose the matching platform:

Use cPanel, DirectAdmin, or Plesk when hosting accounts run on that panel.
Use Proxmox for VM, container, and host context.
Use Solus2 when the setup also needs SolusVM2 API details.
Use Remote Agent when Konrado.AI must proxy through another network.
Use Generic MCP when you already have a custom MCP endpoint.

Add Integration - select a platform

Install

Log in to the target server as root, copy the generated command from the Konrado.AI modal, and run it in the SSH session.

Use the matching --platform value in the generated command:

Platform	Command
cPanel	`bash <(curl -s https://repo.konrado.ai/init.sh) --api-key=YOUR_API_KEY --callback-url=https://app.konrado.ai/api/integrations/servers/install --platform=cpanel`
DirectAdmin	`bash <(curl -s https://repo.konrado.ai/init.sh) --api-key=YOUR_API_KEY --callback-url=https://app.konrado.ai/api/integrations/servers/install --platform=directadmin`
Plesk	`bash <(curl -s https://repo.konrado.ai/init.sh) --api-key=YOUR_API_KEY --callback-url=https://app.konrado.ai/api/integrations/servers/install --platform=plesk`
Proxmox	`bash <(curl -s https://repo.konrado.ai/init.sh) --api-key=YOUR_API_KEY --callback-url=https://app.konrado.ai/api/integrations/servers/install --platform=proxmox`

Run the installer as root. The script installs and registers the Konrado.AI MCP server agent for the selected hosting platform.

After running the installer, Konrado.AI waits for the server to report back. A successful installation shows Connected Successfully in the installation modal and marks the integration as Connected.

Control Panel Plugin installation modal showing a successful server connection

Troubleshooting

Issue	What to check
Command fails immediately	Confirm you are running it as root on the target server
Status stays waiting	Confirm the server can reach `app.konrado.ai` over HTTPS
Wrong platform connected	Delete the integration and create a new one with the correct platform
Panel data is missing	Confirm the selected platform matches the software installed on the server

Installation Failure Commands

If the installation modal shows Connection Error, check both server plugin services, read the recent logs, then restart the plugin services.

Control Panel Plugin installation modal showing a connection error

systemctl status   konrado-server.service konrado-root.service
journalctl         -u konrado-server.service -u konrado-root.service --since "15 minutes ago" --no-pager
systemctl restart  konrado-server.service konrado-root.service
systemctl enable   konrado-server.service konrado-root.service
ss -ltnp | grep ':8000'

After the services restart, run Test Connection again in Konrado.AI. If the status still fails, check firewall rules and make sure Konrado.AI can reach the server plugin URL.

Remove

Use Uninstall Plugin to remove the agent from the server, then delete the integration in Konrado.AI.