# rClient CLI Guide

{% embed url="<https://youtu.be/K547uJwZCOI>" %}

## **Latest CLI version - v3.0.1**

***

## Prerequisites

Ensure you have the following installed on your system:

* Node.js version 20.0.0 (To install node.js please refer to this: <https://nodejs.org/en/download/package-manager>)
* Yarn or NPM

***

## Installation:

To install the Rivalz Node CLI globally, run the following command:

## 1. Mac

```
sudo npm i -g rivalz-node-cli
```

## 2. Windows

&#x20;Open Terminal or Command Prompt with Run as Administrator

<figure><img src="/files/Y6YhU1v8izF114PQJX1y" alt=""><figcaption></figcaption></figure>

then install:

```
npm i -g rivalz-node-cli
```

**note:** By default on windows 11 your PowerShell says "execution of scripts is disabled on this system." To solve this problem you need to type "Set-ExecutionPolicy RemoteSigned" and select "Yes" After that you can type "npm i -g rivalz-node-cli"

## 3. Linux

1. Run `sudo su` to grant administrator privileges

```
sudo su
```

2. then run the command to install

```
npm i -g rivalz-node-cli
```

<figure><img src="/files/hFNPvwDOofMJL94OS8RZ" alt=""><figcaption></figcaption></figure>

***

## Run rClient

After installing the <mark style="color:green;">`rivalz-node-cli`</mark>, follow the steps below to configure and run the <mark style="color:green;">`rClient`</mark>.

**Step 1**: In your terminal, enter:

```bash
rivalz run
```

**Note for Mac, Linux Users:**

You need to add `sudo` to the command to grant the necessary permissions:

```
sudo rivalz run
```

**Step 2**: You will be prompted to enter several pieces of information related to your system and node setup. Here’s what you’ll need:

1. Your wallet address
2. CPU core
3. RAM
4. Select disk type
5. Select disk serial number
6. Enter disk size, you want to allow the client to use

If your configuration is valid, the terminal will display as shown in the image below:

<figure><img src="/files/FS0JRv9ziF7Ze5npjQaz" alt=""><figcaption></figcaption></figure>

***

## Display Info

By running the <mark style="color:green;">rivalz info</mark> command you can display the current version and config of the client&#x20;

<figure><img src="/files/uVez1KxAM7XOA21wM0bR" alt=""><figcaption></figcaption></figure>

***

## List of Commands

<mark style="color:green;">run</mark> - Run the Rivalz rClient CLI

{% hint style="info" %}
**For Mac and Linux:**

You need to add `sudo` to the command to grant the necessary permissions
{% endhint %}

<mark style="color:green;">change-hardware-config</mark> - Update the rClient CLI configuration

<mark style="color:green;">update-version</mark> - Update the rClient CLI version

<mark style="color:green;">info</mark> - Show the rClient CLI version

<mark style="color:green;">report-error</mark> - Report the error logs&#x20;

<mark style="color:green;">clear-log</mark> - Clears the log files of the rClient CLI

<mark style="color:green;">help \[command]</mark> - Display additional info for a specific command

***

## FAQs:

Remember this is Rome v1, so you might encounter bugs. Please report on[ Discord. ](https://discord.com/invite/rivalzai)

**Q: How long does it take to see that my rClient is connected?**

A: Usually within 5min, but might take up to 30min in rare cases.

**Q: What can I do, if it doesn't appear?**

A: Try restarting the rClient. Other methods will be released later.&#x20;

**Q: How can I update to this new version?**

A: Run <mark style="color:green;">Rivalz update-version</mark> OR <mark style="color:green;">npm i -g rivalz-node-cli\@3.0.1</mark>

**Q: Is there a GUI version available?**

A: No. We will announce once we have a GUI version.

**Q: Which cloud infra provider should I use to run the CLI?**

A: You can ONLY use: Vultr, AWS Lightsail, Google Compute, Azure VM, Digital Ocean, OVH cloud

***

[Learn more about rClientCLI version 3.0.1](/rclients-rome/rclient-cli-guide/release-notes-rclientcli/v3.0.1.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.rivalz.ai/rclients-rome/rclient-cli-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.