(DEB) Worker Nodes (Docker) Setup

🚀 BrinxAI Worker Node Installation Guide (Ubuntu AMD64)

IMPORTANT: You must register your node and get a node_UUID from the BrinxAI Dashboard before running the installation script.

🔐 1. Register Your Worker Node

  1. Go to https://brinxai.com/dashboard

  2. Log in or create an account.

  3. Navigate to "Add Node".

  4. Enter a Node Name and click "Add Node".

  5. Copy the generated node_UUID – you’ll need this during installation.

🔥 2. Firewall Setup (Port 5011 or Custom Port)

# Check if UFW is installed
sudo ufw status

# If not, install it
sudo apt-get install ufw

# Allow default port (5011) or your chosen port
sudo ufw allow 5011/tcp

# Enable firewall if not already enabled
sudo ufw enable

# Verify firewall rules
sudo ufw status

🐳 3. Install Docker

Follow the official Docker instructions for Ubuntu: 👉 Docker Engine on Ubuntu

Make sure you also have:

  • curl

  • gnupg

  • lsb-release

  • wget

⚙️ 4. Run the Installation Script

Download & Run the Script

# Download script
wget https://raw.githubusercontent.com/admier1/BrinxAI-Worker-Nodes/refs/heads/main/install_brinxai_worker_amd64_deb.sh

# Make executable
chmod +x install_brinxai_worker_amd64_deb.sh

# Run the script
./install_brinxai_worker_amd64_deb.sh

During Script Execution:

  • Enter your desired port (default: 5011)

  • Enter the node_UUID you got from the dashboard

The script will:

  • Install necessary packages

  • Check for GPU support

  • Configure .env and docker-compose.yml

  • Pull the latest Worker Node image

  • Launch the container using Docker Compose

  • Deploy Watchtower to auto-update the container daily at 4 AM

🧪 5. Verify the Installation

# Check container status
docker ps -a --filter "name=brinxai_worker_amd64"

# If it's not running, view logs
docker logs brinxai_worker_amd64

🖥️ (Optional) Enable GPU Support

Before running the script, install:

📝 Notes

  • Ensure firewall allows the port you selected.

  • Watchtower updates the container daily at 4 AM.

  • For issues, consult logs or the GitHub repo: BrinxAI Worker Nodes GitHub

Would you like a downloadable PDF version or a one-pager you can share with your team?

PreviousWorker Nodes SetupNextModels Setup

Last updated