Skip to main content

Configure Rift Service

Once you have configured the machine for either [Docker], [VM] or Bare Metal (coming soon) rental - install and configure Rift system service.

Sign Up & Activate the Account​

To start using CloudRift, please sign up at cloudrift.ai.

Configuring Rentable Machines​

info

All steps below are included in our setup script, which can be found on GitHub.

Prerequisites​

Before you begin, ensure your system has the following tools installed. These are required for downloading scripts, managing permissions, and installing packages.

  • curl: For downloading scripts and files.
  • sudo: For running commands as root.
sudo apt-get update
sudo apt-get install -y curl sudo

CloudRift System Service​

Any Linux distribution is supported, but we typically test on Ubuntu 22.04.

curl -L https://cloudrift.ai/install-rift-service.sh | sudo sh

1. CloudRift CLI​

Install CloudRift CLI to configure the system service.

curl -L https://cloudrift.ai/install-rift.sh | sh

2. Configure Credentials​

Configure credentials using the rift command line tool by running:

sudo rift configure
note

We're running the rift system service as root, so we need to configure it as root.

You can also edit the config manually. It is located at /root/.config/cloudrift/credentials.yml.

info

If editing manually, ensure you have the correct permissions and YAML formatting.

3. Restart System Service and Check Status​

Restart CloudRift system service and check the status of the service and Docker Engine.

sudo systemctl restart rift
sudo systemctl status rift
sudo systemctl status docker
tip

You can use client_setup.sh to install and configure rift service:

sudo client_setup.sh --only=rift

Testing CloudRift Setup​

1. Install CloudRift CLI​

Install CloudRift CLI on your local machine. Installation instructions vary depending on your OS.

Loading...

2. Configure Credentials​

Configure your credentials using the rift command line tool by running:

rift configure

3. Inspect the Cluster​

Inspect the cluster. You should see all machines that you've installed CloudRift service on:

rift cluster info

4. Run Your First Job​

If you have configured the machine for Docker - you can test it immediately. Otherwise, contact us and we'll help you to configure the console for VM rental.

Run your first job. For example, to run a simple echo command:

rift docker run --rm alpine echo "Hello CloudRift"

Troubleshooting​

  • Docker or NVIDIA driver issues: Ensure you have rebooted after installation or removal of drivers. Check nvidia-smi and docker info.
  • Permission errors: Make sure you are running commands as root or with sudo.
  • Service not starting: Check logs with sudo journalctl -u rift or sudo systemctl status rift.

Next Steps​

For more information on how to use the CloudRift platform to lease your computational resources, please see our documentation or send a request to dc@cloudrift.ai.

We support a variety of integrations, e.g., marketplace, white-label website, custom integration, and more.