You can install the CloudRay Agent on Vultr instances (known as Compute Instances) using:

  • Option 1: Automatic installation during instance creation using Startup Scripts

  • Option 2: Manual installation on existing instances

The CloudRay Agent enables secure, real-time visibility into your infrastructure without SSH. It connects your Vultr server directly to the CloudRay dashboard for monitoring and remote task automation.

TIP

Sign in to CloudRay and retrieve your REG_CODE from your project dashboard before continuing.

Option 1: New Instances (via Startup Script)

Vultr supports Startup Scripts, which run on your server at the first boot. You can use this to install the CloudRay Agent automatically.

  1. Go to the Vultr Control Panel
  2. Click Products → Add Instance
  3. Select Add New Script, give it a name like CloudRay Agent, and paste the following:
#!/bin/bash
curl -sSfL https://cloudray.io/install.sh | bash
sudo cloudray-agent -d --reg-code <REG_CODE>

The install.sh script is safe to re-run. It updates the Agent if needed or skips installation if already present.

Option 2: Existing Servers

To install the CloudRay Agent manually on a running Vultr instance:

  1. Connect to your server
  2. Run the following commands:
curl -sSfL https://cloudray.io/install.sh | sudo bash
sudo cloudray-agent install-service --reg-code <REG_CODE>
  1. Verify that the server appears in your CloudRay dashboard under Machines.

Alternative: Connect via SSH

If you’re unable to install the CloudRay Agent directly on your server, you can still connect and manage your server via SSH. CloudRay supports executing scripts over a standard SSH connection.

Keep in mind that some advanced functionalities—such as real-time monitoring and task syncing—are only available when the Agent is installed.

To learn more about managing servers using SSH, see the Managing Server SSH Keys documentation.