Documentazione / Per iniziare

Risolvere i problemi

Cosa controllare quando installazione, certificato, email o dati in arrivo non funzionano.

Parti da qui, qualunque sia il problema:

closeyourit doctor     # disco, app, certificato, backup, ingest, versione
closeyourit status     # quali servizi sono accesi
closeyourit logs       # cosa dicono l'app e il worker

L'installer si ferma

Messaggio	Cosa fare
`run it as root (sudo bash)`	lancia il comando con `sudo`
`unsupported CPU`	il server non è `x86_64` né `arm64`
`curl is missing`, `openssl is missing`	installa il pacchetto e rilancia
`already has an install: use 'closeyourit update'`	CloseYourIt c'è già; per aggiornarlo lancia `closeyourit update`
`could not read the latest version from GitHub`	il server non raggiunge GitHub; controlla il suo accesso a internet
`the app did not start`	leggi il log: `cd /opt/closeyourit && docker compose logs app`

L'indirizzo non si apre, o il browser avvisa sul certificato

Il certificato arriva solo quando sono vere tutte queste cose:

il dominio punta a questo server (l'installer ti avvisa se non è così);
le porte 80 e 443 sono aperte, sul server e sul firewall del fornitore;
nient'altro sul server usa già quelle porte.

Sistema quello che manca, poi guarda cosa dice il web server:

cd /opt/closeyourit && docker compose logs caddy

Il certificato viene richiesto di nuovo da solo: non serve reinstallare.

Non arriva nessuna email

SMTP_ADDRESS è vuoto in /opt/closeyourit/.env: allora CloseYourIt non manda niente. Compila le impostazioni SMTP e lancia closeyourit restart. Vedi Impostazioni.
Le impostazioni ci sono ma la posta non arriva: closeyourit logs mostra l'errore restituito dal server SMTP.
La posta finisce nello spam: il dominio di MAIL_FROM deve permettere al tuo server SMTP di spedire per lui (record SPF e DKIM presso il tuo fornitore DNS).

Ho perso la password dell'amministratore

Usa "Password dimenticata" nella pagina di accesso. Serve l'email funzionante: se l'hai saltata, imposta prima l'SMTP.

Un'applicazione manda dati ma non si vede niente

Manda una richiesta a mano e leggi la risposta; vedi API HTTP.

Risposta	Causa
`401`	il token è sbagliato, revocato, oppure è la chiave pubblica usata dove serve il token segreto
`404`	l'id del progetto nell'indirizzo non è il progetto del token
`422`	il corpo non è quello che quell'indirizzo si aspetta
`429`	troppe richieste: rallenta e rispetta `Retry-After`
`202` con `accepted: 0`	la funzione è spenta per quel progetto, oppure la richiesta sembrava di un bot
`202`, ma ancora niente	i dati li salva il worker: controlla con `closeyourit status` che `worker` sia acceso

Il disco si riempie

df -h /opt/closeyourit
docker system df

Database: accorcia quanto restano i dati per i progetti più rumorosi. Vedi Database.
Versioni vecchie: ogni aggiornamento lascia indietro l'immagine precedente. docker image prune toglie quelle non usate.
Coda dell'ingest: può arrivare a 4 GB mentre l'app è spenta, e si svuota quando l'app torna.

Un aggiornamento non è riuscito

Se dice che la versione non è stata trovata, controlla il numero: non è cambiato niente. Altrimenti closeyourit update torna da solo alla versione e ai file di prima e te lo dice. Il backup fatto subito prima è in /opt/closeyourit/backups/. Leggi closeyourit logs per capire perché la versione nuova non è partita, poi riprova.

Il paese delle visite è vuoto

Il database dei paesi non c'è. Vedi "Paesi nelle statistiche web" in Impostazioni.

Ancora bloccato

Apri una issue su GitHub con l'output di closeyourit doctor e le righe utili di closeyourit logs. Togli prima token e password.