🩺Risoluzione dei problemi

Il pallino in fondo alla barra laterale

Diventa arancione o rosso quando qualcosa ha bisogno di te (disco, memoria, un job pianificato fallito, un servizio fermo, Claude non connesso, un backup vecchio). Cliccaci sopra per vedere l'elenco. Visto su un problema fa sì che non venga più conteggiato nel pallino (resta nell'elenco, in grigio): torna da solo quando cambia qualcosa - per esempio un altro job che fallisce - oppure dopo 24 ore se è ancora presente. La freccia accanto a un problema già visto lo conteggia di nuovo. I segni di "visto" sono salvati sul server, quindi valgono su tutti i dispositivi.

Parti dal doctor

maxxing doctor            # human readable, exit code 1 if something fails
maxxing doctor --json     # for scripts and Claude
maxxing doctor --live     # also makes a real one-line Claude call

Oppure apri una sessione e scrivi "something is wrong, use the maxxing-doctor skill": Claude legge i controlli e i log, ti spiega cosa succede e sistema ciò che è sicuro sistemare.

Log

journalctl -u claude-maxxing -n 100 --no-pager     # server
journalctl -u caddy -n 50 --no-pager               # HTTPS proxy
systemctl list-units 'maxxing-*'                   # running Claude turns
journalctl -u maxxing-<id8> --no-pager             # one turn
maxxing cron list                                  # jobs and their last result

I log sono visibili anche in Impostazioni -> Sistema.

Problemi comuni

Un comando è stato "Killed" (exit code 137), o un render pesante si è fermato. La memoria è finita. Ogni sessione e ogni job pianificato può usare al massimo il 75 % della RAM del server: oltre questo limite il kernel ferma solo il processo più grande di quella sessione, e Claude te lo dice e continua. L'interfaccia e le altre sessioni normalmente continuano a funzionare (il limite vale per sessione: più sessioni pesanti insieme possono comunque riempire la RAM). Chiedi a Claude un modo più leggero (una risoluzione più bassa, un render a parti, meno input alla volta). Per cambiare il limite, imposta unit_memory_max in /var/lib/claude-maxxing/config.json ("4G", "90%", oppure "" per nessun limite): vale per i turni e i job successivi. Tutti i job pianificati in esecuzione insieme condividono inoltre jobs_memory_max (predefinito 75 %, applicato da maxxing init). journalctl -k | grep -i oom mostra cosa è stato fermato. Se l'intero turno si è fermato, la sessione dice "The turn was stopped: the server ran out of memory".

Qualcosa che hai avviato sul server (un sito di sviluppo, un'API sulla porta 3000…) non è raggiungibile. Il firewall lascia entrare solo SSH, 80/443 e Tailscale. Apri la porta di proposito (ufw allow 3000/tcp) o, meglio ancora, pubblicalo dietro Caddy sul tuo dominio.

L'installer si ferma a "Claude Code". Mostra la fine dell'output dell'installer di Anthropic e la causa probabile sopra l'errore (log completo: /tmp/maxxing-claude-install.log). Cause abituali: downloads.claude.ai non raggiungibile dal server (DNS, firewall in uscita del provider, un'interruzione temporanea - ha già riprovato una volta), un paese in cui Claude non è disponibile (https://www.anthropic.com/supported-countries), un disco pieno, oppure un'architettura diversa da x86_64 / arm64. Risolvi il problema e rilancia curl -fsSL https://get.harness-maxxing.com | bash: i passaggi già completati vengono saltati. (Lanciarlo dopo sudo -i va bene: Claude Code viene installato per root.)

L'installer dice "could not record the Enterprise key". Solo con LICENSE=HM-… (non serve alcuna chiave: lasciala fuori). L'installazione è comunque completata; lancia maxxing license activate per capire perché: chiave sconosciuta (controllala nell'email della tua licenza), chiave revocata, oppure già attiva su un altro server (una chiave = un server): lancia maxxing license release su quello che non usi più.

maxxing update dice che il server "still runs the code of a signed archive". Un server installato con una chiave prima della 2.0.0a87 passa da solo al repository git pubblico; il messaggio dice cosa lo trattiene (nessuna rete, modifiche a web/ nella cartella del codice, un aggiornamento in fase di completamento). Risolvi e lancia di nuovo maxxing update.

La pagina non si carica. systemctl status claude-maxxing. Se è in errore, leggi il journal. Dopo un git pull manuale, lancia invece maxxing update (sincronizza le dipendenze). systemctl restart claude-maxxing è sicuro: i turni di Claude in esecuzione continuano nelle loro unità.

Errore del certificato / dominio non raggiungibile. Il record DNS del dominio deve puntare al server (getent ahosts ui.example.com), e le porte 80 e 443 devono essere aperte (ufw status, più il firewall del tuo provider di hosting). Caddy ottiene il certificato alla prima richiesta: journalctl -u caddy mostra perché non è riuscito. Per validare la configurazione: caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile.

Password dimenticata. Sul server: maxxing password. Oppure ricomincia con un nuovo link di configurazione: maxxing setup-link --reset.

"Too many attempts". Aspetta 15 minuti, oppure riavvia il servizio.

Link di configurazione perso. maxxing setup-link.

Tutte le sessioni falliscono insieme. Claude non ha l'accesso effettuato oppure il token è scaduto: Impostazioni -> Claude -> Test, oppure maxxing doctor --live. Rinnovalo con claude setup-token.

Una sessione resta "in esecuzione". Premi Stop. Se persiste: systemctl list-units 'maxxing-*' e leggi il journal di quell'unità.

Una nota dice che la conversazione non ha potuto essere ripresa. La trascrizione di Claude mancava; è stato avviato automaticamente un contesto nuovo. La cronologia resta visibile.

Un job non è stato eseguito. maxxing cron list (è attivo? ultimo risultato?), crontab -l (la sua riga è nel blocco gestito?), maxxing cron sync, systemctl status cron. Eseguilo a mano: maxxing cron run <id>.

Un job viene eseguito all'ora sbagliata. Il demone cron usa il fuso orario del sistema, l'interfaccia usa quello di Impostazioni -> Generali. maxxing doctor mostra entrambi. Su un server condiviso, mantieni l'orologio del server e lascia che i job seguano il tuo fuso: maxxing init --system-clock keep. Altrimenti allineali: timedatectl set-timezone <Zone> && systemctl restart cron, e maxxing init --timezone <Zone> && systemctl restart claude-maxxing.

Telegram è muto. maxxing telegram status mostra l'ultimo errore; maxxing telegram test. Vedi Telegram.

Backup fallito. maxxing backup status. Token scaduto, repository reso pubblico, oppure un segreto trovato in un file (il messaggio indica il file). Vedi Backup.

Disco pieno. Controlla ~/.claude/projects (trascrizioni), gli allegati nei topic e il journal (journalctl --vacuum-size=200M). Elimina con attenzione: le trascrizioni servono per riprendere le sessioni.

L'interfaccia sembra non aggiornata dopo un aggiornamento. Ricarica la pagina; l'HTML dell'app non viene mai messo in cache, basta una ricarica.

L'URL di Tailscale smette di funzionare dopo un riavvio. Se l'IP di Tailscale è cambiato, rilancia l'installer con ACCESS=tailscale (oppure maxxing init --bind <ip> --public-url http://<ip>:8787 e riavvia).

Sei ancora bloccato?

Raccogli maxxing doctor --json e le ultime 200 righe di journalctl -u claude-maxxing (controlla che non contengano segreti) e contatta il supporto.