Skip to main content

Run a Compute Node

Setting up and operating a Compute Node within the Peerz network involves understanding several technical details, from the execution of server commands to ensuring your node is correctly integrated and recognized within the network. This guide combines crucial steps, including system prerequisites, command-line operations, establishing initial peer connections, and the essential registration process for network participation and incentive eligibility.

System and Software Prerequisites

Before launching your Peerz Compute Node, your system should meet these requirements:

  • Operating System Compatibility: Linux (Ubuntu 18.04+, CentOS 7+) or macOS (Mojave 10.14+).
  • Python Version: Ensure Python 3.8+ is installed to align with Peerz's dependencies.
  • Hardware Specifications: A CUDA-compatible GPU is recommended for computational tasks, though not mandatory. At least 5 GB of disk space is required for smooth operation.
  • Network Setup Know-How: Understanding of network configurations, specifically for managing port forwarding if behind NAT.

Note: Unfamiliar with Peerz's core concepts? It's crucial to visit the Core Concepts documentation to grasp the foundational elements of Peerz.

Installation

Assuming Peerz is installed on your system (refer to the Installation Guide for details), you can start a server using the peerz command-line interface. For detailed installation instructions, please visit the Installation Guide.

Launching the Server

Start a Peerz server using the peerz server command, accompanied by parameters tailored to your operational needs:

peerz server --converted_model_name_or_path <MODEL_PATH> --port <PORT>

Command-Line Options Overview

Some notable command options include:

  • --converted_model_name_or_path: Indicates the model's path or name, pre-converted for Peerz compatibility.
  • --port: Specifies the listening port; Peerz auto-selects a free port if this is left unspecified.
  • --public_name: An optional node identifier for network-wide recognition.
  • --public_ip: For servers with direct internet access, stating your public IPv4 address facilitates external connectivity.

A detailed command list and explanations are accessible via:

peerz server -h

Establishing Initial Peer Connections

The --initial_peers option is pivotal for your node's network integration, requiring specification of initial peer addresses:

Peer AddressDescription
/ip4/.../p2p/...Addresses of known peers for initial connectivity.

Example command with initial peers:

peerz server --initial_peers /ip4/203.0.113.1/tcp/31337/p2p/QmSomePeerId ...

Adjust the addresses based on your network's configuration, ensuring your node can successfully join the Peerz DHT network.

Blockchain Registration for Network Incentives

After the node initiates and displays its Peer ID, this ID must be registered on the blockchain, linking your server to the Peerz ecosystem and establishing eligibility for incentives.

Critical Warning: Blockchain Registration

warning

Server Registration Mandatory: To fully integrate into the Peerz network and qualify for incentives, register your server's Peer ID on the blockchain. Securely note your Peer ID and consult the Peerz Mine for comprehensive registration instructions.

Step-by-Step Registration

  1. Identify Peer ID: Note the Peer ID displayed during server startup.
  2. Prepare for Registration: Collect your Peer ID and the wallet address intended for incentive receipts.
  3. Proceed to Registration: Detailed registration guidance, including portal access, is provided at Peerz Mine.

This process ensures your server is acknowledged as an active participant in the Peerz network, making it eligible for computational contribution incentives.

Conclusion

Operating a Peerz compute node encompasses precise command-line configurations, network integration through initial peers, and the crucial step of registering your node for blockchain recognition. This guide furnishes you with the knowledge for a successful node setup and integration into the Peerz network, ensuring your contributions are properly incentivized.

For further details, advanced configurations, or troubleshooting, refer to the Peerz Documentation, your comprehensive resource for all things Peerz.