# Troubleshooting

| Sintomo | Causa / rimedio |
|---|---|
| Certificato non emesso | DNS non punta all'IP pubblico, 80/443 chiuse o in uso; `docker compose logs caddy` |
| Link/clone con URL sbagliato | `ROOT_URL`, `SSH_DOMAIN`, `SSH_PORT` non coerenti |
| Porta 2222 occupata | `ss -tlnp \| grep 2222`, cambiare porta host e `SSH_PORT` |
| `Permission denied (publickey)` | chiave non registrata; `ssh -vT -p 2222 git@dominio` |
| Push rifiutato dopo restore/spostamento | `gitea admin regenerate hooks` |
| Errori permessi su `/data` | `USER_UID/GID` ≠ proprietario di `./gitea-data`; `chown` |
| Login ok ma IP client = 172.x | `REVERSE_PROXY_TRUSTED_PROXIES` mancante |
| Aggiornamenti live assenti | WebSocket `/-/ws` bloccato dal proxy |
| Job Actions in coda | nessun runner registrato / label non corrisponde |
| Pagina /install riappare | `INSTALL_LOCK` non true o `app.ini` non persistito |
| Schema DB anomalo | `gitea doctor check --all --fix` (backup prima) |

Diagnosi base:
```bash
docker compose ps
docker compose logs --tail=100 gitea caddy
docker exec -u git gitea gitea doctor check --all
```