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.

Manual Build from Source

If you’re a developer or contributor, you can build the Agent from source using Rust.

Refer to the main Agent documentation for build instructions.

Alternative: Connect via SSH

If you are unable to install the Agent on your server, CloudRay also supports management over a secure SSH connection. However, some advanced features may not be available via SSH.

To learn more about managing servers using SSH, see the Managing Server SSH Keys documentation.