docker-voltronic-homeassistant/SETUP_GITEA_TOKEN.md

Setup Token Gitea per Container Registry

Passaggi per creare il token:

1. Vai su Gitea:

   • Apri https://gitea.home-nas-ds.org
   • Login con il tuo account

2. Crea un Access Token:

   • Clicca sull'avatar in alto a destra → Settings
   • Vai su Applications nel menu laterale
   • Scorri fino alla sezione Generate New Token

3. Configura il token:

   • Token Name: github-actions-registry (o un nome a tua scelta)
   • Select Permissions:
     • ✓ write:package (per push su Container Registry)
     • ✓ read:package (per pull da Container Registry)
   • Clicca su Generate Token

4. Copia il token:

   • ⚠️ IMPORTANTE: Copia il token generato immediatamente, non sarà più visibile!
   • Esempio: f8a3b2c1d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9

5. Aggiungi il token come Secret nel repository:

   • Vai al repository: https://gitea.home-nas-ds.org/Alessio/docker-voltronic-homeassistant
   • Clicca su Settings (icona ingranaggio)
   • Nel menu laterale: Secrets → Actions
   • Clicca su Add Secret
   • Name: REGISTRY_TOKEN
   • Value: [incolla il token copiato]
   • Clicca su Add Secret

6. Verifica:

   • Torna alla pagina Actions
   • Riavvia il workflow fallito oppure fai un nuovo push
   • Il workflow dovrebbe ora autenticarsi correttamente

Troubleshooting

Se l'errore persiste:

1. Verifica che il Container Registry sia abilitato:

   # Controlla se il registry risponde
   curl https://gitea.home-nas-ds.org/v2/
   

   Dovrebbe rispondere con {"errors":[{"code":"UNAUTHORIZED",...}]}

2. Test login manuale con il token:

   echo "TUO_TOKEN" | docker login gitea.home-nas-ds.org -u Alessio --password-stdin
   

3. Verifica configurazione Gitea:

   • Vai su Site Administration → Configuration
   • Cerca la sezione "Packages"
   • Assicurati che ENABLED sia true