Servers in CloudRay are resources that store the information needed to connect to your own remote cloud servers. They consist of the server’s address and the SSH credentials (username, password, or SSH key) required to access it. CloudRay itself does not provide cloud servers. 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 use CloudRay to run scripts on it via SSH.

TIP

If you’re using SSH keys for authentication, refer to the Setup SSH Key Guide for step-by-step instructions.

Adding a Server

To run scripts on your remote server using CloudRay, you first need to add the server to your account. This process involves specifying the server’s details and authentication method.

Follow the steps below to connect your server to CloudRay.

  1. Navigate to Servers: Click on the “Servers” tab in the main navigation.
Screenshot of adding a new server
  1. Click “New Server”: Initiate the process by clicking the “New Server” button
  2. Choose an option: Select “I want to add my existing server” to add your server to CloudRay
Screenshot of choosing an option
  1. Server Details:
Screenshot of Server setup
  • Host: Enter the domain name (e.g., example.com) or IP address (e.g., 167.99.34.227) of your cloud server. If your SSH server uses a non-standard port (not 22), include it in the host (e.g., example.com:2222)
  • SSH User: The username on your server with the necessary permissions to execute scripts (e.g., ubuntu or root)
  • Authentication: Choose one of the following methods:
    • SSH Password: Your server’s SSH password
    • SSH Key: Select an existing SSH key from the “Server Keys” section or create a new one
  1. Save and Verify: Click “Create Server” to add your server
Screenshot of testing connection

Then, click “Test Connection” to ensure CloudRay can establish a connection.

Screenshot of testing connection

A Runlog entry will be created, detailing the connection attempt.

Managing Your Servers

Once you’ve added a server to CloudRay, you can manage its settings as needed. This includes viewing details, updating configuration settings, and removing servers you no longer use.

Viewing Server Details

Screenshot of testing connection

To check a server’s configuration, simply click on the server in the list. This will display its server names, host, SSH user, and other settings

Editing Server Settings

If you need to modify your server’s details, follow these steps:

Screenshot of edit server
  1. Click “Edit” next to the server you wish to update
Screenshot of edit server

  1. Modify the server name, SSH host, SSH username, or authentication details as needed

  2. Click “Update Server” to save your changes

Troubleshooting Connection Problems

If you’re having trouble connecting your server to CloudRay, the issue may be related to authentication, network accessibility, or SSH configuration. Below are some common problems and how to resolve them:

  • Authentication Failures: Verify your SSH credentials (username, password/key) and ensure the SSH key is properly linked to the server within CloudRay
  • Network Issues: Confirm your server is online, reachable from the internet, and that your firewall allows incoming SSH connections from CloudRay
  • Non-Standard SSH Port: If using a non-standard SSH port, double-check that you’ve included it correctly in the “Hostname” field (e.g., example.com:2222)