> For the complete documentation index, see [llms.txt](https://docs.rivalz.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rivalz.ai/znode-validators/running-a-znode.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.rivalz.ai/znode-validators/running-a-znode.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.