Machines in CloudRay represent your own physical or virtual servers where tasks and scripts are executed. These machines can be connected either through the CloudRay Agent (recommended) or SSH (for environments where the Agent cannot be installed). You will need to obtain your own server from providers like Google Cloud, AWS, DigitalOcean, Linode, or others. Once you have a server, you can register it as a machine in CloudRay to start running scripts, automations, or jobs.

Choosing a Connection Method

Choosing a Connection Method There are two supported ways to connect your machines:

  • ✅ Recommended: Install the CloudRay Agent on your machine for secure, real-time, zero-SSH orchestration.
  • 🛠 Alternative: Connect via SSH if installing the Agent isn’t possible on your machine

Adding a Machine

You can add a new machine from the Machines section of your CloudRay dashboard.

  1. Go to Machines: From the sidebar, navigate to Machines.
  2. Click “New Machine” to start the process.
Add new machine

CloudRay allows you to connect different types of environments whether it’s a cloud-based instance, an on-premise personal device, or a remote server over SSH. Choose the connection method that best fits your infrastructure and security posture.

If you choose the CloudRay Agent, you’ll receive an installation command to run on your server. Once the agent is installed and running, your machine will automatically register with CloudRay and show up in your dashboard.

Option 2: SSH-Based Machine

If installing the CloudRay Agent isn’t feasible, you can connect machines using secure SSH access.

Follow this guide to add an SSH-based server →