# Installa, directory dei dati e log
Source: https://nordvec.com/it/docs/guides/desktop/install-and-data

Cosa installa l'app desktop di Nordvec su Windows, macOS e Linux, ogni file che scrive sul disco e dove si trova il suo file di log.



Questa pagina indica dove l'app desktop scrive su ogni sistema operativo, per
tua documentazione personale o per una revisione IT. È generata dalla configurazione
di build dell'app e dai nomi dei file che il suo codice scrive, quindi cambia quando questi vengono modificati.

L'app è **Nordvec Desktop**, con ID applicazione `com.nordvec.desktop`.

## Windows [#windows]

* **Installer:** un programma di installazione `.exe` per x64.
* **Installa per:** l'installer chiede se installare solo per te o per tutti sul computer. Solo per te è preselezionato e non richiede diritti di amministratore.
* **Cartella di installazione:** puoi sceglierla nell'installer.
* **Disinstallare** rimuove la directory dei dati qui sotto insieme all'app. L'aggiornamento no.
* **Directory dei dati:** `%APPDATA%\Nordvec Desktop`
* **File di log:** `%APPDATA%\Nordvec Desktop\logs\nordvec-<date>.log`

## macOS [#macos]

* **Download:** un'immagine disco (`.dmg`) o un archivio `.zip`, per Mac con Apple silicon e Intel (un'unica build universale).
* **Richiede:** macOS 13.0 o successivo.
* **Rimuovere l'app** lascia intatta la directory dei dati qui sotto; eliminala per rimuovere i dati di sincronizzazione locali.
* **Directory dei dati:** `~/Library/Application Support/Nordvec Desktop`
* **File di log:** `~/Library/Application Support/Nordvec Desktop/logs/nordvec-<date>.log`

## Linux [#linux]

* **Download:** un AppImage per x64. Funziona come tuo utente, senza installazione a livello di sistema.
* **Rimuovere l'app** lascia intatta la directory dei dati qui sotto; eliminala per rimuovere i dati di sincronizzazione locali.
* **Portachiavi:** l'app necessita di un gnome-keyring o KWallet in esecuzione per crittografare i dati di sincronizzazione locali e non sincronizza senza uno di essi.
* **Directory dei dati:** `~/.config/Nordvec Desktop`
* **File di log:** `~/.config/Nordvec Desktop/logs/nordvec-<date>.log`
* Quando `XDG_CONFIG_HOME` è impostato, la directory dei dati è `$XDG_CONFIG_HOME/Nordvec Desktop` invece.

## Cosa contiene la directory dei dati [#cosa-contiene-la-directory-dei-dati]

Tutto ciò che l'app conserva sul tuo computer si trova nella directory dei dati per il tuo sistema operativo, come indicato sopra. Ogni account connesso ha il proprio archivio di sincronizzazione.

| Nome                              | Cosa contiene                                                                                                                                                                                                                                                                  |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `sync-state-<account key>.sqlite` | Lo store di sincronizzazione per un account connesso: cartelle monitorate, esclusioni, code di caricamento e rimozione e cosa è stato sincronizzato. Nomi e percorsi dei file al suo interno sono crittografati con una chiave protetta dal portachiavi del sistema operativo. |
| `logs/nordvec-<date>.log`         | Il log dell'app per un giorno. Registra eventi, conteggi e codici di errore, e ogni riga indica la versione dell'app che l'ha scritta. È scritto per non contenere nomi di file, percorsi o contenuti dei file.                                                                |
| `logs/nordvec-<date>.1.log`       | La parte precedente del log di un giorno, conservata quando il log giornaliero raggiunge il limite di dimensione. Al massimo uno al giorno.                                                                                                                                    |
| `window-state.json`               | L'ultima dimensione e posizione della finestra.                                                                                                                                                                                                                                |
| `ui-locale`                       | La lingua dell'ultima pagina mostrata dall'app, in modo che il menu della barra delle applicazioni e le notifiche la utilizzino.                                                                                                                                               |
| `update-health.json`              | Quando l'app ha controllato per l'ultima volta gli aggiornamenti e se i controlli stanno fallendo.                                                                                                                                                                             |
| `whats-new-version`               | L'ultima versione di cui l'app ha mostrato l'elenco delle modifiche, in modo che le modifiche di ogni aggiornamento siano mostrate una sola volta.                                                                                                                             |
| `first-run-done`                  | Segna che il primo avvio è stato eseguito, quindi l'avvio all'accesso è attivato solo per una nuova installazione.                                                                                                                                                             |
| `crash-ledger.json`               | Quando l'app si è arrestata l'ultima volta a causa di un errore, solo come orari, in modo che un secondo arresto subito dopo la riapertura la mantenga chiusa invece di riaprirla.                                                                                             |

Mentre l'archivio di sincronizzazione è aperto, SQLite mantiene i file `-wal`, `-shm`, `-journal` accanto a `sync-state-<account key>.sqlite`; appartengono all'archivio. L'app conserva anche i cookie e lo storage del sito della sessione connessa nella directory dei dati. Lo store dei cookie è crittografato con una chiave protetta dal keychain del sistema operativo.

Su un computer che ha eseguito una build precedente, potresti trovare anche:

| Nome                                     | Cosa contiene                                                                                                                                                                                                       |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sync-state.json`                        | Stato scritto da una build precedente. Al momento dell'accesso, l'app lo consegna all'account che lo possiede e lo mantiene se non riesce a determinarne il proprietario.                                           |
| `logs/nordvec.log`                       | Il log scritto da una build precedente. Viene eliminato insieme ai log giornalieri una volta che è abbastanza vecchio.                                                                                              |
| `logs/nordvec.log.old`                   | Il log precedente conservato da una build precedente, eliminato alle stesse condizioni.                                                                                                                             |
| `sync-state-<account key>.json`          | Stato per account scritto da una build precedente. Al momento dell'accesso, l'app lo copia nello store di sincronizzazione e lo rinomina una volta letta la copia.                                                  |
| `sync-state-<account key>.json.imported` | Lo stesso stato precedente dopo che i suoi contenuti sono stati copiati nello store di sincronizzazione. Contiene nomi e percorsi dei file non crittografati e nulla lo legge di nuovo, quindi è sicuro eliminarlo. |

## File di log [#file-di-log]

L'app scrive un file di log al giorno, `logs/nordvec-<date>.log` nella
directory dei dati, dove la data è il giorno sul tuo computer. Per aprire la loro
cartella dall'app, scegli **Guida > Mostra file di log**. Quando il log di un giorno raggiunge
5 MB, le righe precedenti vengono spostate in
`nordvec-<date>.1.log`, quindi un giorno mantiene al massimo due file.

L'app conserva gli ultimi 14 giorni, incluso oggi, e al massimo
50 MB di log in totale, eliminando prima i giorni più vecchi.
Non elimina mai il log di oggi e elimina solo i file con questi nomi.

Ogni riga indica la build che l'ha scritta, come
`v=<version> sha=<commit>` dopo l'orario e il livello.

## Quale versione hai [#quale-versione-hai]

* Windows: scegli **Guida > Informazioni su Nordvec Desktop**.
* macOS: scegli **Nordvec Desktop > Informazioni su Nordvec Desktop**.
* Linux: scegli **Guida > Informazioni su Nordvec Desktop**.
* Ad ogni avvio, viene scritta anche una riga che inizia con `app_ready version=` nel file di log, seguita dalla versione.

## Segnalazione di un problema [#segnalazione-di-un-problema]

Controlla prima i [problemi noti](/docs/guides/desktop/known-issues). Per segnalare un bug, includi la versione dell'app e, se possibile, il file di log. L'app è scritta in modo da non registrare nomi di file, percorsi o contenuti dei file, ma leggi il log prima di condividerlo e rimuovi tutto ciò che non vuoi inviare.
