Mimante/Mimante/UNRAID_TEMPLATE.md

?? GUIDA CONFIGURAZIONE UNRAID - AutoBidder v1.2.0

?? Template Container Unraid

Informazioni Base

Nome: AutoBidder
Descrizione: Sistema automatizzato gestione aste Bidoo
Repository: gitea.encke-hake.ts.net/alby96/autobidder:1.2.0
WebUI: http://[IP]:[PORT:8889]
Icon URL: (opzionale)

---

?? Configurazione Parametri

1. Port Mappings

Nome	Container Port	Host Port	Tipo	Descrizione
WebUI	8080	8889	TCP	Interfaccia web AutoBidder

Configurazione Unraid:

Container Port: 8080
Host Port: 8889
Connection Type: TCP

---

2. Volume Mappings

Nome	Container Path	Host Path	Modo	Descrizione
AppData	/app/Data	/mnt/user/appdata/autobidder/data	Read/Write	Database e configurazioni
Logs	/app/logs	/mnt/user/appdata/autobidder/logs	Read/Write	Log applicazione (opzionale)

Configurazione Unraid:

Volume 1:
  Container Path: /app/Data
  Host Path: /mnt/user/appdata/autobidder/data
  Access Mode: Read/Write

Volume 2 (opzionale):
  Container Path: /app/logs
  Host Path: /mnt/user/appdata/autobidder/logs
  Access Mode: Read/Write

---

3. Environment Variables (OBBLIGATORIO)

?? Autenticazione Applicazione

Variable	Valore	Descrizione
ADMIN_USERNAME	admin	Username amministratore
ADMIN_PASSWORD	MyS3cur3P@ss!2024	Password admin (min 12 caratteri)

Requisiti password:

• ? Minimo 12 caratteri
• ? Maiuscole + minuscole
• ? Numeri
• ? Simboli speciali

?? Sessione Bidoo

NON servono credenziali qui!

Il cookie di sessione Bidoo si configura dall'interfaccia web:

1. Login su AutoBidder
2. Vai su Settings ? Sessione Bidoo
3. Incolla il cookie di sessione ottenuto da Bidoo.it
4. Salva

?? Opzionali

Variable	Valore Default	Descrizione
ASPNETCORE_ENVIRONMENT	Production	Ambiente ASP.NET
USE_POSTGRES	true	Usa PostgreSQL per stats
LOG_LEVEL	Information	Livello logging

---

?? Template Completo Unraid

XML Template (my-AutoBidder.xml)

<?xml version="1.0"?>
<Container version="2">
  <Name>AutoBidder</Name>
  <Repository>gitea.encke-hake.ts.net/alby96/autobidder:1.2.0</Repository>
  <Registry>https://gitea.encke-hake.ts.net/</Registry>
  <Network>bridge</Network>
  <MyIP/>
  <Shell>sh</Shell>
  <Privileged>false</Privileged>
  <Support>https://gitea.encke-hake.ts.net/Alby96/Mimante</Support>
  <Project>https://gitea.encke-hake.ts.net/Alby96/Mimante</Project>
  <Overview>Sistema Blazor .NET 8 per monitoraggio e partecipazione automatica aste Bidoo</Overview>
  <Category>Tools:</Category>
  <WebUI>http://[IP]:[PORT:8889]</WebUI>
  <TemplateURL/>
  <Icon>https://raw.githubusercontent.com/selfhosters/unRAID-CA-templates/master/templates/img/bidoo.png</Icon>
  <ExtraParams/>
  <PostArgs/>
  <CPUset/>
  <DateInstalled></DateInstalled>
  <DonateText/>
  <DonateLink/>
  <Requires/>
  
  <Config Name="WebUI Port" Target="8080" Default="8889" Mode="tcp" Description="Porta interfaccia web" Type="Port" Display="always" Required="true" Mask="false">8889</Config>
  
  <Config Name="AppData" Target="/app/Data" Default="/mnt/user/appdata/autobidder/data" Mode="rw" Description="Database e configurazioni persistenti" Type="Path" Display="always" Required="true" Mask="false">/mnt/user/appdata/autobidder/data</Config>
  
  <Config Name="Logs" Target="/app/logs" Default="/mnt/user/appdata/autobidder/logs" Mode="rw" Description="Log applicazione (opzionale)" Type="Path" Display="advanced" Required="false" Mask="false">/mnt/user/appdata/autobidder/logs</Config>
  
  <Config Name="Admin Username" Target="ADMIN_USERNAME" Default="admin" Mode="" Description="Username amministratore AutoBidder" Type="Variable" Display="always" Required="true" Mask="false">admin</Config>
  
  <Config Name="Admin Password" Target="ADMIN_PASSWORD" Default="" Mode="" Description="Password amministratore (min 12 caratteri, maiuscole, minuscole, numeri, simboli)" Type="Variable" Display="always" Required="true" Mask="true"></Config>
  
  <Config Name="Environment" Target="ASPNETCORE_ENVIRONMENT" Default="Production" Mode="" Description="Ambiente ASP.NET" Type="Variable" Display="advanced" Required="false" Mask="false">Production</Config>
  
  <Config Name="Use PostgreSQL" Target="USE_POSTGRES" Default="true" Mode="" Description="Usa PostgreSQL per statistiche avanzate" Type="Variable" Display="advanced" Required="false" Mask="false">true</Config>
  
  <Config Name="Log Level" Target="LOG_LEVEL" Default="Information" Mode="" Description="Livello logging (Debug, Information, Warning, Error)" Type="Variable" Display="advanced" Required="false" Mask="false">Information</Config>
</Container>

---

?? Installazione Step-by-Step

Step 1: Aggiungi Container

1. Unraid WebUI ? Docker ? Add Container
2. Click: Advanced View (top right)

Step 2: Configurazione Base

Name: AutoBidder
Repository: gitea.encke-hake.ts.net/alby96/autobidder:1.2.0
Network Type: Bridge
Console shell command: Shell

Step 3: Port Mappings

Container Port: 8080
Host Port: 8889
Protocol: TCP

Step 4: Path Mappings

Container Path: /app/Data
Host Path: /mnt/user/appdata/autobidder/data
Access Mode: Read/Write

Step 5: Environment Variables

OBBLIGATORIO - Autenticazione:

Key: ADMIN_USERNAME
Value: admin

Key: ADMIN_PASSWORD
Value: TuaPasswordSicura123!

Sessione Bidoo:

NON configurare qui!
Si imposta dall'interfaccia web dopo il login.

Opzionali:

Key: ASPNETCORE_ENVIRONMENT
Value: Production

Key: USE_POSTGRES
Value: true

Key: LOG_LEVEL
Value: Information

Step 6: Apply e Start

1. Click Apply
2. Unraid scaricherà l'immagine
3. Container si avvierà automaticamente

---

? Verifica Installazione

1. Controlla Log

Unraid ? Docker ? AutoBidder ? Log

Log attesi:

[Identity] Database initialized
[Identity] Admin user created: admin
[DB] Database initialized successfully
[Kestrel] Listening on: http://+:8080
Application started

2. Test WebUI

Browser: http://192.168.30.23:8889

Dovresti vedere:

• ? Redirect automatico a /login
• ? Pagina login AutoBidder

3. Primo Login

Username: admin
Password: (valore ADMIN_PASSWORD)

Dopo login:

• ? Homepage AutoBidder
• ? Monitoring aste attivo

---

?? Troubleshooting

Problema: Container non parte

Verifica log:

Unraid ? Docker ? AutoBidder ? Log

Cause comuni:

• ? ADMIN_PASSWORD non configurata
• ? BIDOO_USERNAME o BIDOO_PASSWORD mancanti
• ? Port 8889 già in uso

Soluzione:

1. Stop container
2. Edit container
3. Verifica environment variables
4. Start container

Problema: "Account temporaneamente bloccato"

Causa: 5 tentativi login falliti

Soluzione:

• Aspetta 15 minuti (lockout automatico)
• Verifica password configurata

Problema: Pagina non carica

Verifica:

1. Container è "Started" (Unraid Docker)
2. Port 8889 corretto
3. IP Unraid corretto

Test:

# SSH su Unraid
curl http://localhost:8889

Problema: Bidoo non si connette

Verifica:

1. BIDOO_USERNAME e BIDOO_PASSWORD corretti
2. Account Bidoo attivo
3. Log container per errori connessione

Log:

Unraid ? Docker ? AutoBidder ? Log
Cerca: [Bidoo] o [Session]

---

?? Aggiornamento Versione

Da v1.1.x a v1.2.0

1. Stop container:

   Unraid ? Docker ? AutoBidder ? Stop
   

2. Edit container:

   Unraid ? Docker ? AutoBidder ? Edit
   

3. Aggiorna repository:

   Repository: gitea.encke-hake.ts.net/alby96/autobidder:1.2.0
   

4. Aggiungi nuove env vars:

   ADMIN_USERNAME=admin
   ADMIN_PASSWORD=TuaPasswordSicura123!
   BIDOO_USERNAME=email@bidoo.com
   BIDOO_PASSWORD=bidoo_pass
   

5. Apply e Start

6. Verifica log (primo avvio)

---

?? Checklist Configurazione

Prima di avviare container:

• Repository corretto (1.2.0)
• Port mapping: 8889:8080
• Volume: /app/Data ? /mnt/user/appdata/autobidder/data
• ADMIN_USERNAME configurato
• ADMIN_PASSWORD configurata (min 12 caratteri)
• BIDOO_USERNAME configurato
• BIDOO_PASSWORD configurata
• WebUI accessibile da browser

Dopo avvio:

• Log non mostra errori
• Login funzionante
• Homepage AutoBidder carica
• Connessione Bidoo OK

---

?? Esempio Configurazione Completa

=== CONTAINER SETTINGS ===
Name: AutoBidder
Repository: gitea.encke-hake.ts.net/alby96/autobidder:1.2.0
Network: bridge

=== PORT MAPPINGS ===
8080 (container) ? 8889 (host) [TCP]

=== VOLUME MAPPINGS ===
/app/Data ? /mnt/user/appdata/autobidder/data [RW]
/app/logs ? /mnt/user/appdata/autobidder/logs [RW]

=== ENVIRONMENT VARIABLES ===
ADMIN_USERNAME=admin
ADMIN_PASSWORD=MyS3cur3P@ssw0rd!2024
ASPNETCORE_ENVIRONMENT=Production
USE_POSTGRES=true
LOG_LEVEL=Information

=== SESSIONE BIDOO ===
Configurata dall'interfaccia web:
Settings ? Sessione Bidoo ? Incolla cookie

=== ACCESS ===
WebUI: http://192.168.30.23:8889
Login: admin / MyS3cur3P@ssw0rd!2024

---

?? Supporto

Documentazione:

• SECURITY.md - Guida sicurezza
• README.md - Overview progetto
• CHANGELOG.md - Note versioni

Log dettagliati:

Unraid ? Docker ? AutoBidder ? Log

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

---

?? AutoBidder v1.2.0 - Pronto per Unraid con autenticazione sicura!