Salta ai contenuti
Custodir Docs

Troubleshooting top 15

Se Custodir si comporta in modo strano, prima cerca qui. Se il tuo caso non è elencato, scrivi a supporto@custodir.com — risposta entro 48h.

1. Custodir non parte / finestra grigia

Sintomo: doppio click sull’icona, nessuna finestra appare, oppure appare grigia.

Causa probabile: il server locale Node interno non è partito (porta occupata, antivirus blocca, OneDrive ha pinnato un file).

Fix:

  1. Click destro icona tray → Esci.
  2. Apri Task Manager (Ctrl+Shift+Esc) → cerca “Custodir” → termina eventuali processi orfani.
  3. Riapri Custodir dal menu Start.

Se persiste: vedi %AppData%\Custodir\logs\main.log per stack trace ed eventuale EADDRINUSE.

2. SmartScreen blocca l’installer

Sintomo: “Windows ha protetto il PC” all’installazione.

Causa: binario non firmato code-sign (BADR-016: rimandato post-50 vendite).

Fix: clicca Ulteriori informazioni → Esegui comunque. È sicuro — il codice è open source su GitHub.

3. “Master password errata” su un PC nuovo

Sintomo: restore di un backup → master password rifiutata.

Causa probabile: stai inserendo una password diversa da quella originale, oppure il backup è corrotto.

Fix:

  1. Verifica di aver inserito la stessa password del PC originale (case sensitive, accenti contano).
  2. Se la password è giusta ma il backup non funziona: usa un backup precedente (Custodir mantiene gli ultimi 30 giorni).
  3. Se nessun backup funziona: la master password non è recuperabile — è il prezzo della privacy by design. Inizia da zero.

4. Setup wizard non parte dopo skip

Sintomo: hai cliccato “Salta” nel wizard e ora vuoi tornarci.

Fix: Impostazioni → Account → Riapri wizard.

5. Transazione importata 2 volte

Sintomo: vedi una transazione doppia in timeline.

Causa: dedup hash diverso (es. timestamp leggermente diverso tra CSV e email).

Fix:

  1. Apri Operazioni, identifica la duplicazione.
  2. Click sulla riga → Storna. Custodir crea una contropartita (transactions sono immutabili — Golden Rule).
  3. Reporta a supporto@custodir.com il pattern così possiamo migliorare il dedup.

6. Sync Trade Republic via IMAP “0 email parsate”

Sintomo: IMAP si connette ma nessuna transazione importata.

Causa: TR non spedisce email all’indirizzo collegato, oppure stanno in spam.

Fix:

  1. Su TR app: Account → Notifiche → Email verifica Conferme operazioni: ON.
  2. Su Gmail: controlla Spam e Tutti i messaggi per email da tradingrep…. Sposta in inbox.
  3. Riprova il sync.

7. Prezzi non si aggiornano

Sintomo: la pagina Portafoglio mostra prezzi vecchi di giorni.

Causa: Yahoo Finance ha cambiato API o il PC non è acceso da qualche giorno.

Fix:

  1. Verifica connessione internet.
  2. Impostazioni → Prezzi → Sync manuale.
  3. Se l’errore persiste: %AppData%\Custodir\logs\scheduler.log mostra la chiamata API e l’errore esatto.

8. AI agent “budget esaurito”

Sintomo: notifica Telegram: agenti disattivati, budget 100% raggiunto.

Fix:

  • Aspetta il primo del mese (azzeramento auto), oppure
  • Impostazioni → Agenti AI → Override per +€5 boost emergenza.
  • Considera passare a Groq free se sei su Anthropic.

9. Bot Telegram non risponde

Sintomo: /status al bot e nessuna risposta.

Fix:

  1. Verifica di aver linkato (/link con codice fresco).
  2. Verifica che Telegram non abbia bloccato il bot.
  3. Stato bot live: @Custodir_Bot status — se è down lo segnaliamo in chat profile.

10. Backup non parte automaticamente

Sintomo: ultimi backup vecchi di settimane.

Causa: PC spento durante l’orario schedulato, oppure disco esterno non collegato.

Fix:

  1. Impostazioni → Backup → Stato: vedi data ultimo backup e prossimo programmato.
  2. Se serve, esegui backup manuale + verifica la destinazione.

11. Schermate vuote / “Errore caricamento”

Sintomo: una pagina specifica (es. Performance) non carica.

Fix:

  1. Click su Ricarica.
  2. Se persiste, restart Custodir.
  3. Se ancora: copia il messaggio errore + screenshot e manda a supporto@custodir.com.

12. Custodir lento

Sintomo: apertura lenta, transizioni laggose.

Cause possibili:

  • DB diventato grande (>1 GB). Raro per uso personale ma succede dopo anni di operatività.
  • Antivirus che scansiona ogni accesso al DB cifrato.

Fix:

  • Aggiungi %AppData%\Custodir\ alle eccezioni dell’antivirus.
  • Impostazioni → Manutenzione → Compatta DB (VACUUM SQLite).

13. Custodir mangia RAM (~500 MB+)

Sintomo: Task Manager mostra Custodir a 500+ MB.

Causa: è un’app Electron con Chrome dentro. È normale 200-300 MB idle, picchi 500-800 MB sotto carico (recap AI, render grafici).

Fix: nessuno necessario, è il costo di avere un’app desktop multi-piattaforma. Per ridurre minimizza la finestra (Custodir resta in tray) — Chromium throttla quando non visibile.

14. Cron job non gira di notte

Sintomo: non ricevi recap mattutino, vedi alert “missed job catch-up” all’apertura.

Causa: PC spento di notte. Lo scheduler locale non gira con PC spento.

Fix: comportamento by design. Il cloud orchestrator memorizza i job non eseguiti e li ricostruisce al primo lancio successivo (catch-up). Il recap mattutino arriverà appena accendi il PC.

Per recap puntuale alle 08:00 anche con PC spento → necessita di “Always-on Recap” agent cloud-side (BADR-006 opzione B) — non implementato in v1.

15. Voglio cancellare tutto e ricominciare

Sintomo: vuoi un reset completo, nuovo wizard, niente dati.

Fix:

  1. Disinstalla Custodir.
  2. Cancella manualmente %AppData%\Custodir\ (cartella intera).
  3. Re-installa.

Avrai una nuova installazione vuota. La licenza resta valida.