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:

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

```bash
# 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:

```bash
#!/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:
```bash
docker logs TradingBot -f
```

### Console Access

**Docker tab** ? Container **TradingBot** ? Click **icona console**

O via terminal:
```bash
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

```bash
# 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**:
```bash
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**:
```bash
curl http://localhost:8080/health
# Deve rispondere: Healthy
```

### Performance Issues

**Check risorse**:
```bash
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**:
```bash
# 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` ??