# (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](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)

```bash
# 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](https://docs.docker.com/engine/install/ubuntu/)

Make sure you also have:

* `curl`
* `gnupg`
* `lsb-release`
* `wget`

***

### ⚙️ 4. Run the Installation Script

#### Download & Run the Script

<pre class="language-bash"><code class="lang-bash"># Download script
<strong>wget https://raw.githubusercontent.com/admier1/BrinxAI-Worker-Nodes/refs/heads/main/install_brinxai_worker_amd64_deb.sh
</strong>
# Make executable
chmod +x install_brinxai_worker_amd64_deb.sh

# Run the script
./install_brinxai_worker_amd64_deb.sh
</code></pre>

#### 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

```bash
# 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](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html)

***

### 📝 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](https://github.com/admier1/BrinxAI-Worker-Nodes)

***

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

