Solus2

Connect Solus2 to Konrado.AI with the server integration agent and SolusVM2 API credentials

Use Solus2 when Konrado.AI needs VPS and virtualization context from a SolusVM2 environment.

Estimated time: 10 minutes

Before You Start

Access to Konrado.AI Integrations.
Root SSH access to the server where the integration agent will run.
SolusVM2 API details for the SolusVM2 instance.
Outbound network access from the server to Konrado.AI and to SolusVM2.

What This Connects

Konrado.AI reads SolusVM2 VPS, virtualization, customer, and service context for support tickets.

Install the Agent

In Konrado.AI, open Integrations > Applications, click Add Integration, and choose Solus2.

Solus2 installation instructions

Log in to the target server via SSH as the root user.
Copy the installation command from the Solus2 modal.
Run the command in the SSH session.
Wait for automatic connection detection in Konrado.AI.

The generated command will look like this:

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=solus2

Run the command as root. The script installs the Konrado.AI MCP server agent on the selected server or hosting panel.

Add SolusVM2 API Details

Solus2 also requires these SolusVM2 API values:

Field	Description
`SOLUSVM2_URL`	Hostname or base URL of your SolusVM2 instance
`SOLUSVM2_API_TOKEN`	SolusVM2 API token used by the integration

Create a dedicated API token for this integration. Manage tokens in the SolusVM2 User Auth API: https://docs.solusvm.com/en/solusvm2/api-reference/api/#tag/User-Auth

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
Agent connects but Solus2 data is missing	Verify `SOLUSVM2_URL` and `SOLUSVM2_API_TOKEN`
API authorization fails	Create a new dedicated SolusVM2 API token and update the integration configuration
Status stays waiting	Confirm the server can reach `app.konrado.ai` over HTTPS

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, then delete the integration in Konrado.AI.