The CloudRay Agent supports MacOS systems, allowing you to securely register and manage your Mac in the CloudRay dashboard without needing SSH.

System Requirements

The CloudRay Agent is compatible with:

  • MacOS 10.15 (Catalina) or newer
  • Both Intel and Apple Silicon (M1/M2) processors

TIP

To proceed, make sure you have a CloudRay account and copy your REG_CODE from your project dashboard.

Installation Instructions

To install and register the Agent on your Mac:

  1. Open the Terminal application
  2. Run the following commands (replace <REG_CODE> with your actual code):
curl -sSfL https://cloudray.io/install.sh | sudo bash
sudo cloudray-agent install-service --reg-code <REG_CODE>

You may be prompted to enter your password. This is required to install and register the Agent as a system-level service.

WARNING

Older macOS versions may still work, but they are not officially supported. Please contact support if you run into any issues.

  1. 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.