> For the complete documentation index, see [llms.txt](https://brinxai.gitbook.io/brinxai-depin-ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://brinxai.gitbook.io/brinxai-depin-ai/worker-nodes-setup/deb-worker-nodes-docker-setup.md).

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

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://brinxai.gitbook.io/brinxai-depin-ai/worker-nodes-setup/deb-worker-nodes-docker-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.