Encelado/TradingBot/docs/deployment/UNRAID_NATIVE_INSTALL.md

?? TradingBot - Installazione su Unraid (Senza Portainer)

? Installazione Diretta da Gitea Registry

Puoi installare TradingBot direttamente dall'Unraid Docker Manager usando il tuo Gitea Registry!

---

?? PREREQUISITI

1. Login Gitea Registry su Unraid

SSH su Unraid:

ssh root@192.168.30.23  # O IP Tailscale

# Login al Gitea Registry
docker login gitea.encke-hake.ts.net

# Username: Alby96
# Password: [Personal Access Token Gitea]

Output atteso:

Login Succeeded ?

---

?? METODO 1: Template XML (Consigliato)

Step 1: Copia Template su Unraid

# Su Unraid
mkdir -p /boot/config/plugins/dockerMan/templates-user

# Scarica template
wget -O /boot/config/plugins/dockerMan/templates-user/TradingBot.xml \
  https://gitea.encke-hake.ts.net/Alby96/Encelado/raw/branch/main/TradingBot/unraid-template.xml

Step 2: Installa Container

1. Unraid WebUI ? Docker tab
2. Click Add Container (in fondo)
3. Template: Dropdown ? Seleziona TradingBot
4. Configura (opzionale):
   • Port: 8080 (o cambia se occupata)
   • Data Path: /mnt/user/appdata/tradingbot/data
5. Click Apply

Unraid farà:

• ? Pull immagine da Gitea Registry
• ? Crea container
• ? Crea volume per dati
• ? Start automatico

Step 3: Accedi WebUI

http://192.168.30.23:8080

Dovresti vedere la Dashboard TradingBot! ??

---

?? METODO 2: Installazione Manuale

Se preferisci non usare template:

Step 1: Unraid Docker Tab

1. Docker ? Add Container
2. Name: TradingBot

Step 2: Configurazione Base

Repository:

gitea.encke-hake.ts.net/alby96/encelado/tradingbot:latest

Network Type: Bridge

Console shell command: Shell

Step 3: Port Mapping

Click Add another Path, Port, Variable, Label or Device

Config Type: Port

• Name: WebUI
• Container Port: 8080
• Host Port: 8080 (o altra porta libera)
• Connection Type: TCP

Step 4: Volume Mapping

Click Add another Path, Port, Variable, Label or Device

Config Type: Path

• Name: AppData
• Container Path: /app/data
• Host Path: /mnt/user/appdata/tradingbot/data
• Access Mode: Read/Write

Step 5: Environment Variables

ASPNETCORE_ENVIRONMENT:

• Name: ASPNETCORE_ENVIRONMENT
• Value: Production

ASPNETCORE_URLS:

• Name: ASPNETCORE_URLS
• Value: http://+:8080

Step 6: Health Check (Opzionale)

Extra Parameters:

--health-cmd="wget --no-verbose --tries=1 --spider http://localhost:8080/health || exit 1" --health-interval=30s --health-timeout=3s --health-retries=3 --health-start-period=10s

Step 7: Apply

Click Apply in fondo alla pagina.

---

?? AGGIORNAMENTO CONTAINER

Via Unraid Docker Tab

1. Docker ? Trova TradingBot
2. Click icona ferma (stop container)
3. Click Force Update (icona update)
4. Click icona play (start container)

Unraid farà:

• ? Pull ultima immagine da Gitea
• ? Ricrea container
• ? Mantiene dati (volume persistente)

Automatico con User Scripts Plugin

Installa User Scripts plugin:

1. Apps ? Cerca "User Scripts"
2. Installa

Crea script update:

#!/bin/bash
# Nome: Update TradingBot

# Stop container
docker stop TradingBot

# Remove container
docker rm TradingBot

# Pull latest image
docker pull gitea.encke-hake.ts.net/alby96/encelado/tradingbot:latest

# Recreate container (Unraid fa automaticamente)
# O riavvia manualmente dalla WebUI

echo "Update completato! Riavvia TradingBot dalla Docker tab."

Schedula: Ogni settimana o manualmente.

---

?? GESTIONE CONTAINER

Start/Stop/Restart

Docker tab ? Container TradingBot:

• ?? Play: Start
• ?? Pause: Pausa (mantiene in memoria)
• ?? Stop: Ferma
• ?? Restart: Riavvia

View Logs

Docker tab ? Container TradingBot ? Click icona logs

O via terminal:

docker logs TradingBot -f

Console Access

Docker tab ? Container TradingBot ? Click icona console

O via terminal:

docker exec -it TradingBot bash

Statistics

Docker tab ? Container TradingBot ? Click icona stats

Mostra:

• CPU usage
• Memory usage
• Network I/O
• Block I/O

---

?? ACCESSO WEBUI

Locale (Unraid LAN)

http://192.168.30.23:8080

Via Tailscale

http://unraid.encke-hake.ts.net:8080

(Se hai configurato Tailscale su Unraid)

Reverse Proxy (Opzionale)

Se vuoi accesso HTTPS:

Nginx Proxy Manager (tramite Unraid):

https://tradingbot.encke-hake.ts.net ? http://192.168.30.23:8080

---

?? SICUREZZA

Best Practices

? Porta non esposta pubblicamente (solo LAN o Tailscale)
? Volume dati protetto (/mnt/user/appdata/tradingbot/)
? Registry privato (Gitea richiede login)
? Certificati validi (Tailscale)
? User non-root (già configurato nel Dockerfile)

Backup Dati

# Backup manuale
tar -czf tradingbot-backup-$(date +%Y%m%d).tar.gz \
  /mnt/user/appdata/tradingbot/data

# Restore
tar -xzf tradingbot-backup-20241212.tar.gz -C /

O usa CA Backup / Restore Appdata plugin.

---

?? TROUBLESHOOTING

Container Non Si Avvia

Check logs:

docker logs TradingBot

Problemi comuni:

Porta occupata

Error: address already in use

Fix: Cambia porta in configurazione container

Pull failed

Error: unauthorized: authentication required

Fix: docker login gitea.encke-hake.ts.net

Image not found

Error: manifest not found

Fix: Verifica che l'immagine esista su Gitea Packages

WebUI Non Accessibile

Checklist:

• Container status: running (verde)
• Health check: healthy
• Porta corretta (8080 o custom)
• Firewall Unraid non blocca
• Browser su http:// non https://

Test:

curl http://localhost:8080/health
# Deve rispondere: Healthy

Performance Issues

Check risorse:

docker stats TradingBot

Limiti raccomandati:

• CPU: 2 cores max, 0.5 reserved
• Memory: 1GB max, 256MB reserved

Configura in Extra Parameters:

--cpus="2.0" --memory="1g" --memory-reservation="256m"

---

?? CHECKLIST INSTALLAZIONE

Pre-Install

• Unraid aggiornato
• Docker service attivo
• Porta 8080 disponibile
• docker login gitea.encke-hake.ts.net successful

Install

• Template XML copiato (Metodo 1)
• O container configurato manualmente (Metodo 2)
• Container creato
• Volume dati creato

Post-Install

• Container status: running
• Health check: healthy
• WebUI accessibile
• Settings configurati nell'app

---

?? VANTAGGI UNRAID NATIVO

? Zero dipendenze (no Portainer, no docker-compose)
? WebUI Unraid integrata (gestione familiare)
? Auto-start (container parte con Unraid)
? Backup integrato (con plugin CA)
? Update semplice (1 click)
? Template riutilizzabile (facile reinstall)

---

?? WORKFLOW COMPLETO

Sviluppo (PC)

1. Codice in Visual Studio
2. Build ? Publish (Release)
3. ? Automatico: Push Gitea Registry
4. Commit: git push

Deploy (Unraid)

1. Docker tab ? TradingBot ? Stop
2. Force Update
3. Start
4. Done! ?

Tempo totale: ~2 minuti

---

?? RISORSE

Template XML

https://gitea.encke-hake.ts.net/Alby96/Encelado/raw/branch/main/TradingBot/unraid-template.xml

Repository

https://gitea.encke-hake.ts.net/Alby96/Encelado

Docker Image

gitea.encke-hake.ts.net/alby96/encelado/tradingbot:latest

Support

https://gitea.encke-hake.ts.net/Alby96/Encelado/issues

---

?? TradingBot pronto per Unraid senza Portainer!

Quick Start:

# 1. Login
docker login gitea.encke-hake.ts.net

# 2. Install Template
wget -O /boot/config/plugins/dockerMan/templates-user/TradingBot.xml \
  https://gitea.encke-hake.ts.net/Alby96/Encelado/raw/branch/main/TradingBot/unraid-template.xml

# 3. Docker tab ? Add Container ? TradingBot ? Apply

Access: http://192.168.30.23:8080 ??