CloudRay Agent on Linux
The CloudRay Agent is a lightweight binary that securely connects your Linux machines to the CloudRay platform. It collects system metrics, enables remote task execution, and integrates seamlessly with the CloudRay dashboard — all without needing SSH access.
TIP
You must have a CloudRay account and project set up. You will find the REG_CODE in your project dashboard at app.cloudray.io
Supported Linux Distributions
CloudRay supports the following Linux distributions:
- Ubuntu 18.04 and newer
- Debian 10 and newer
- CentOS 7 and newer
- RHEL 7 and newer
- Fedora 32 and newer
- Amazon Linux 2
For other distributions, the Agent may still work but is not officially supported.
Installation Steps
- Open a terminal on your Linux machine and run:
curl -sSfL https://cloudray.io/install.sh | sudo bash
sudo cloudray-agent install-service --reg-code <REG_CODE>
Replace <REG_CODE>
with your actual registration code from the CloudRay dashboard.
NOTE
The script is idempotent meaning it’s safe to run multiple times. It will update the Agent if a newer version exists or leave it untouched if already up-to-date.
- Check the status of the Agent service:
systemctl status cloudray-agent
You should see the service active and running.
- Visit the CloudRay dashboard, navigate to Machines, and confirm your Linux machine appears as connected.
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.