You can install the CloudRay Agent on UpCloud servers using:

  • Option 1: Automatic installation using Initialization scripts
  • Option 2: Manual installation on existing servers

The CloudRay Agent connects your UpCloud instance to the CloudRay dashboard securely—without SSH. It enables server visibility, automated task execution, and infrastructure monitoring, all from a single control plane.

TIP

Before starting, sign in to CloudRay and copy your REG_CODE from your project dashboard.

Option 1: New Servers (via cloud-init)

UpCloud allows custom scripts via initialization Scripts when creating a server. You can leverage this to automate Agent installation.

  1. Log in to the UpCloud Control Panel
  2. Go to Deploy Server
  3. Locate the Initialization Scripts section
UpCloud cloud-init interface
  1. Paste the following script (replace <REG_CODE>):
#!/bin/bash
curl -sSfL https://cloudray.io/install.sh | bash
sudo cloudray-agent install-service --reg-code <REG_CODE>

The install.sh script is safe to re-run — it will upgrade the Agent if a newer version is available, or leave it unchanged if already installed.

Option 2: Existing Servers

To install the CloudRay Agent manually on a running UpCloud server:

  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.