🩺Dépannage

Le point en bas de la barre latérale

Il devient orange ou rouge quand quelque chose demande votre attention (disque, mémoire, une tâche planifiée échouée, un service arrêté, Claude non connecté, une sauvegarde ancienne). Cliquez dessus pour voir la liste. Vu sur un problème l'empêche de compter dans le point (il reste dans la liste, grisé) : il revient tout seul quand il change - par exemple une autre tâche qui échoue - ou après 24 heures s'il est toujours là. La flèche à côté d'un problème déjà vu le compte à nouveau. Les marques « vu » sont conservées sur le serveur, elles sont donc valables sur tous vos appareils.

Commencez par le 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

Ou ouvrez une session et dites « something is wrong, use the maxxing-doctor skill » : Claude lit les vérifications et les journaux, explique, et corrige ce qui peut l'être sans risque.

Journaux

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

Les journaux sont aussi visibles dans Réglages -> Système.

Problèmes courants

Une commande a été « Killed » (code de sortie 137), ou un rendu lourd s'est arrêté. La mémoire a été épuisée. Chaque session et chaque tâche planifiée peut utiliser au maximum 75 % de la RAM du serveur : au-delà, le noyau arrête uniquement le plus gros processus de cette session, et Claude vous le dit et continue. L'interface et les autres sessions continuent normalement de fonctionner (le plafond est par session : plusieurs sessions lourdes en même temps peuvent quand même remplir la RAM). Demandez à Claude une méthode plus légère (une résolution plus basse, un rendu en plusieurs parties, moins de fichiers à la fois). Pour changer le plafond, définissez unit_memory_max dans /var/lib/claude-maxxing/config.json ("4G", "90%", ou "" pour aucun plafond) : il s'applique aux prochains tours et aux prochaines tâches. Toutes les tâches planifiées qui tournent en même temps se partagent aussi jobs_memory_max (75 % par défaut, appliqué par maxxing init). journalctl -k | grep -i oom montre ce qui a été arrêté. Si le tour entier s'est arrêté, la session indique « The turn was stopped: the server ran out of memory ».

Quelque chose que vous avez lancé sur le serveur (un site de développement, une API sur le port 3000…) n'est pas accessible. Le pare-feu laisse seulement entrer SSH, 80/443 et Tailscale. Ouvrez le port volontairement (ufw allow 3000/tcp), ou mieux, servez-le derrière Caddy sur votre domaine.

L'installateur s'arrête à « Claude Code ». Il affiche la fin de la sortie de l'installateur d'Anthropic et la cause probable au-dessus de l'erreur (journal complet : /tmp/maxxing-claude-install.log). Causes habituelles : downloads.claude.ai inaccessible depuis le serveur (DNS, pare-feu sortant de l'hébergeur, panne temporaire - il a déjà réessayé une fois), un pays où Claude n'est pas disponible (https://www.anthropic.com/supported-countries), un disque plein, ou une architecture autre que x86_64 / arm64. Corrigez le problème et relancez curl -fsSL https://get.harness-maxxing.com | bash : les étapes terminées sont ignorées. (Le lancer après sudo -i convient : Claude Code est installé pour root.)

L'installateur dit « could not record the Enterprise key ». Uniquement avec LICENSE=HM-… (aucune clé n'est nécessaire : omettez-la). L'installation elle-même est terminée ; lancez maxxing license activate pour voir pourquoi : clé inconnue (vérifiez-la dans votre e-mail de licence), clé révoquée, ou déjà active sur un autre serveur (une clé = un serveur) : lancez maxxing license release sur celui que vous n'utilisez plus.

maxxing update dit que le serveur « still runs the code of a signed archive ». Un serveur installé avec une clé avant la version 2.0.0a87 passe tout seul au dépôt git public ; le message indique ce qui le retient (pas de réseau, modifications de web/ dans le dossier du code, une mise à jour en cours de finalisation). Corrigez le problème et relancez maxxing update.

La page ne se charge pas. systemctl status claude-maxxing. S'il est en échec, lisez le journal. Après un git pull manuel, lancez plutôt maxxing update (il synchronise les dépendances). systemctl restart claude-maxxing est sans risque : les tours de Claude en cours continuent dans leurs propres unités.

Erreur de certificat / domaine inaccessible. L'enregistrement DNS du domaine doit pointer vers le serveur (getent ahosts ui.example.com), et les ports 80 et 443 doivent être ouverts (ufw status, ainsi que le pare-feu de votre hébergeur). Caddy obtient le certificat à la première requête : journalctl -u caddy montre pourquoi cela a échoué. Validez la configuration : caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile.

Mot de passe perdu. Sur le serveur : maxxing password. Ou repartez de zéro avec un nouveau lien de configuration : maxxing setup-link --reset.

« Too many attempts ». Attendez 15 minutes, ou redémarrez le service.

Lien de configuration perdu. maxxing setup-link.

Toutes les sessions échouent en même temps. Claude n'est pas connecté ou le jeton a expiré : Réglages -> Claude -> Tester, ou maxxing doctor --live. Renouvelez avec claude setup-token.

Une session reste « en cours ». Appuyez sur Arrêter. Si cela persiste : systemctl list-units 'maxxing-*' et lisez le journal de cette unité.

Une note indique que la conversation n'a pas pu être reprise. La transcription de Claude était absente ; un contexte neuf a été démarré automatiquement. L'historique reste visible.

Une tâche ne s'est pas exécutée. maxxing cron list (activée ? dernier résultat ?), crontab -l (sa ligne est-elle dans le bloc géré ?), maxxing cron sync, systemctl status cron. Lancez-la à la main : maxxing cron run <id>.

Une tâche s'exécute à la mauvaise heure. Le démon cron utilise le fuseau horaire du système, l'interface utilise celui de Réglages -> Général. maxxing doctor affiche les deux. Sur un serveur partagé, gardez l'horloge du serveur et laissez les tâches suivre votre fuseau : maxxing init --system-clock keep. Sinon, alignez-les : timedatectl set-timezone <Zone> && systemctl restart cron, et maxxing init --timezone <Zone> && systemctl restart claude-maxxing.

Telegram reste silencieux. maxxing telegram status montre la dernière erreur ; maxxing telegram test. Voir Telegram.

La sauvegarde a échoué. maxxing backup status. Jeton expiré, dépôt rendu public, ou secret trouvé dans un fichier (le message nomme le fichier). Voir Sauvegarde.

Disque plein. Vérifiez ~/.claude/projects (transcriptions), les pièces jointes dans les sujets, et le journal (journalctl --vacuum-size=200M). Supprimez avec précaution : les transcriptions sont nécessaires pour reprendre les sessions.

L'interface semble obsolète après une mise à jour. Rechargez la page ; le HTML de l'application n'est jamais mis en cache, un rechargement suffit.

L'URL Tailscale ne fonctionne plus après un redémarrage. Si l'IP Tailscale a changé, relancez l'installateur avec ACCESS=tailscale (ou maxxing init --bind <ip> --public-url http://<ip>:8787 puis redémarrez).

Toujours bloqué ?

Rassemblez maxxing doctor --json et les 200 dernières lignes de journalctl -u claude-maxxing (vérifiez qu'elles ne contiennent aucun secret) et contactez le support.