docs: add CLAUDE.md and docs/ configuration reference

docs/troubleshooting.md

@@ -0,0 +1,22 @@
+# 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
+```