# Running a zNode

Running a **zNode** allows users to actively secure the Rivalz network by verifying data integrity, and ensuring safe access to reliable, unaltered information. To run a zNode users are required to purchase a license.

## **1. Technical Requirements to run zNodes:**

Before installing ZNode, make sure your system meets the following requirements:

* Operating System: Ubuntu 20.04 LTS or higher, macOS, Windows 10 or higher.
* Memory: Minimum 2 GB of RAM \[Recommend 8 GB].
* Storage: Recommended 128GB of free disk space.
* CPU: Recommended 10th-generation Intel Core i3.
* Network: A stable internet connection.
* Dependencies: Node.js (v20.x or higher).

## 2. Installation

###   2.1. Prerequisites

Make sure the following tools are installed before starting the ZNode installation:

<figure><img src="/files/qnVAWJHcPjCo4PeGVkri" alt=""><figcaption><p>Tools Installation Requirements</p></figcaption></figure>

You need to have Node.js and npm installed on your machine. You can download Node.js from [here](https://nodejs.org/en/download/), and npm is included with the Node.js installation.

### &#x20; 2.2. Installing Znode

&#x20;   **Step 1: Open the terminal**

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

&#x20;   **Step 2: Enter the command `npm i -g rivalz-znode-cli`**

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

&#x20;   **ZNode is now installed and ready for use.**

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

## 3. Basic Commands

### &#x20; **3.1. Running the ZNode with the command: `znode run`**

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

### &#x20; **3.2. Displaying ZNode information with the command:  `znode info`**

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

### &#x20; **3.3. Updating the ZNode version with the command: `znode update-version`**

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

### &#x20; **3.4. Displaying the Node ID with the command: `znode show-node-id`**

<figure><img src="/files/3pkUuIBelcppVajKNnlN" alt=""><figcaption></figcaption></figure>

### &#x20; **3.5. Displaying the ZNode version with the command: `znode -V`**

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

## 4. Advanced Usage

### &#x20; 4.1. Delegate Node

{% hint style="info" %} <mark style="color:red;">Before delegating a node, ensure your wallet contains at least 1 NFT and has sufficient gas.</mark>
{% endhint %}

&#x20;   **Step 1: Open the terminal**

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

**Step 2: Enter the command  `znode info`**

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

&#x20;   **Step 3: Copy the node ID (0x9f7c….33c) and then open the link** <https://znode.rivalz.ai/licenses>

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

&#x20;   **Step 4: On the website, you'll need to connect your wallet.**

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

&#x20;   **Step 5: Enter the "Node ID" and "Number of licenses to delegate".**

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

&#x20;   **Step 6: Click the “Delegate” button after signing transaction.**

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

&#x20;   **If the transaction is successful, the UI will automatically reload.**

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

&#x20;   **Step 7: Return to the terminal and run the zNode again using the command  `znode run`  to start the  node.**

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

### &#x20; 4.2. Revoke Node

{% hint style="info" %} <mark style="color:red;">Before revoking a node, ensure your wallet is running at least one node and has sufficient gas.</mark>
{% endhint %}

&#x20;   **Step 1: You need go to** “<https://znode.rivalz.ai/licenses>” **and then connect wallet.**

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

&#x20;   **Step 2: Select the License ID you would like to revoke, then click the "Undelegate" button.**

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

&#x20;   **Step 3: Sign the transaction.**

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

&#x20;**If the transaction is successful, the UI will automatically reload.**

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

&#x20;**Step 4: Return to the terminal and run the zNode again using the command  `znode run`  to start the node.**

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

&#x20;

<br>


---

# 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/znode-validators/running-a-znode.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.