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 can’t install the CloudRay Agent, you can still manage your machines using SSH. See SSH-Based Servers to get started with traditional SSH connections.