Worker Nodes (Setup)

System Requirements for Worker Nodes

Minimum Requirements

To ensure basic functionality of the Worker Node, your system should meet the following minimum specifications:

  • CPU: 8 VCPU Cores

  • Memory: 16GB RAM

  • Storage: 300GB SSD

  • GPU: Optional (A GPU can significantly boost performance and earnings)

  • Port: 5011 needs to be open (Can be changed to any Port)

For optimal performance and to maximize earnings, we recommend the following system specifications:

  • CPU: 16+ VCPU Cores

  • Memory: 64GB+ RAM

  • Storage: 1TB+ SSD

  • GPU: NVIDIA RTX 2060 or higher (AMD and Intel AREC is not supported yet)

  • Port: 5011 needs to be open (Can be changed to any Port)

Firewall Setup

To ensure your Worker Node can communicate properly, you'll need to configure your firewall to allow traffic on the port you've chosen (default: 5011). Below are the instructions for setting up firewall rules on both Linux and Windows.

Linux (Ubuntu) Firewall Setup

  1. Check if UFW (Uncomplicated Firewall) is installed:

    sudo ufw status

    If UFW is not installed, you can install it with:

    sudo apt-get install ufw
  2. Allow the required port:

    To allow traffic on port 5011, run the following command:

    sudo ufw allow 5011/tcp

    If you've chosen a different port, replace 5011 with your selected port number.

  3. Enable UFW:

    If UFW is not already enabled, enable it with:

    sudo ufw enable
  4. Verify the UFW status:

    Ensure that the rule has been added and UFW is active:

    sudo ufw status

Windows Firewall Setup

  1. Open Windows Firewall:

    • Press Win + R, type firewall.cpl, and press Enter.

    • In the Windows Firewall window, click on "Advanced settings" on the left side.

  2. Create a new inbound rule:

    • In the "Windows Firewall with Advanced Security" window, click on "Inbound Rules" on the left pane.

    • Click on "New Rule…" on the right pane.

  3. Rule Type:

    • Select "Port" and click "Next."

  4. Protocol and Ports:

    • Choose "TCP."

    • Specify the port number (default: 5011). If you've chosen a different port, replace 5011 with your selected port number.

    • Click "Next."

  5. Action:

    • Choose "Allow the connection" and click "Next."

  6. Profile:

    • Select when the rule applies (Domain, Private, Public). Generally, leave all selected.

    • Click "Next."

  7. Name the Rule:

    • Give your rule a name, e.g., "BrinxAI Worker Node."

    • Click "Finish."

Installation on Linux & Windows

Step 1: Install Docker

To install Docker on your Linux Ubuntu system, please follow the instructions provided in the official Docker documentation by visiting Docker Engine Installation.

https://docs.docker.com/engine/install/ubuntu/

To install Docker on your Windows system, please follow the instructions provided in the official Docker documentation by visiting Docker Engine Installation.

https://docs.docker.com/desktop/install/windows-install/

Step 2: Pull Worker Image from Docker Hub

Run the following commands in your terminal:

docker pull admier/brinxai_nodes-worker:latest

Step 3: Install NVIDIA Drivers for Docker (optional)

Follow the guide below before proceeding if you want GPU Enabled.

https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html

Step 4: Run Worker Docker Image

  • Linux (Ubuntu): Run the following commands in your terminal:

    git clone https://github.com/admier1/BrinxAI-Worker-Nodes
    cd BrinxAI-Worker-Nodes
    chmod +x install_ubuntu.sh
    ./install_ubuntu.sh

  • Windows (PowerShell):

    If you are using PowerShell, run the following commands:

    git clone https://github.com/admier1/BrinxAI-Worker-Nodes
    cd BrinxAI-Worker-Nodes
    .\install_windows.ps1

Step 5: Register Your Worker Node

  1. Create an account using your email and password.

  2. Log in to your account.

  3. Find your IP address by visiting What Is My IP Address or using the ifconfig command in the terminal.

  4. Enter your Node Name (Any) and IP address in the Worker Dashboard and click "Add Node".

Last updated