ui-tracker/UNRAID.md

Unraid Installation Guide — UI Stock Tracker

---

Step 1 — CLI: Clone and Build the Image

SSH into your Unraid server and run:

mkdir -p /mnt/user/appdata/ui-tracker
cd /mnt/user/appdata/ui-tracker
git clone https://github.com/<your-username>/ui-tracker.git .
docker build -t ui-tracker .

The first build takes a few minutes — it compiles the React frontend, compiles the Node.js backend, and installs Chromium inside the image. Once complete, the image is available locally as ui-tracker.

---

Step 2 — GUI: Add the Container in Unraid

In the Unraid web UI go to Docker → Add Container.

Fill in each section as follows:

---

Basic

Field	Value
Name	ui-tracker
Repository	ui-tracker
Icon URL	(leave blank)

---

Network

Field	Value
Network Type	br0
Fixed IP Address	Your chosen static LAN IP — e.g. 192.168.1.50

With br0, the container gets its own IP on your LAN. You will access the UI directly at http://<fixed-ip>:8080 — no port conflict with the Unraid host.

---

Port

Click Add another Path, Port, Variable, Label or Device → select Port.

Field	Value
Name	Web UI
Container Port	8080
Host Port	8080
Protocol	TCP

---

Path (Persistent Data)

Click Add another Path, Port, Variable, Label or Device → select Path.

Field	Value
Name	Data
Container Path	/app/data
Host Path	/mnt/user/appdata/ui-tracker/data
Access Mode	Read/Write

This is where the SQLite database lives. All tracked items and Telegram settings persist here across restarts and rebuilds.

---

Variables

No environment variables are required — all configuration is baked into the image.

---

Click Apply to create and start the container.

---

Step 3 — First-Time Setup

Open the UI at http://<fixed-ip>:8080 and:

1. Click Settings (top right)
2. Enter Bot Token: 8769097441:AAFBqPlSTcTIi3I-F5ZIN9EEpwbNDzHg8hM
3. Enter Chat ID: 8435449432
4. Click Test Alert — a Telegram message should arrive within seconds
5. Click Save
6. Click Add Item, paste a store.ui.com product URL, set your check interval, click Start Tracking

---

Rebuilding After an Update

cd /mnt/user/appdata/ui-tracker
git pull
docker stop ui-tracker
docker rm ui-tracker
docker build -t ui-tracker .

Then go back to Docker → Add Container and re-add it with the same settings, or start it from the Docker tab if Unraid retained the template.

---

Troubleshooting

UI not loading

• Confirm the container is running in the Docker tab
• Check logs: click the container icon → Logs
• Make sure your fixed IP isn't already in use on the network

Telegram test fails

• Verify the bot token and chat ID in Settings
• Send /start to your bot in Telegram at least once to open the conversation
• Confirm Unraid has outbound HTTPS (port 443) access

Items stuck on "Unknown" status

• Open container logs and look for Puppeteer errors
• Restart the container from the Docker tab — Chromium occasionally needs a clean start