(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:

• NVIDIA GPU Drivers

• NVIDIA Container Toolkit

---

📝 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?