# Installation, Datenverzeichnis und Protokolle
Source: https://nordvec.com/de/docs/guides/desktop/install-and-data

Was die Nordvec-Desktop-App unter Windows, macOS und Linux installiert, welche Dateien sie auf die Festplatte schreibt und wo sich deine Protokolldatei befindet.



Diese Seite zeigt, wo die Desktop-App auf jedem Betriebssystem schreibt, für deine eigenen Aufzeichnungen oder eine IT-Prüfung. Sie wird aus der Build-Konfiguration der App und den Dateinamen generiert, die ihr Code schreibt, und ändert sich, wenn sich diese ändern.

Die App ist **Nordvec Desktop**, Anwendungs-ID `com.nordvec.desktop`.

## Windows [#windows]

* **Installer:** ein `.exe`-Setup-Programm für x64.
* **Installation für:** Der Installer fragt, ob du die Installation nur für dich oder für alle auf dem Computer durchführen möchtest. Nur für dich ist vorausgewählt und benötigt keine Administratorrechte.
* **Installationsordner:** Du kannst ihn im Installer auswählen.
* **Deinstallation** entfernt das unten genannte Datenverzeichnis zusammen mit der App. Ein Update nicht.
* **Datenverzeichnis:** `%APPDATA%\Nordvec Desktop`
* **Logdatei:** `%APPDATA%\Nordvec Desktop\logs\nordvec-<date>.log`

## macOS [#macos]

* **Download:** ein Disk-Image (`.dmg`) oder ein `.zip`-Archiv, für Apple Silicon und Intel Macs (ein Universal-Build).
* **Erforderlich:** macOS 13.0 oder neuer.
* **App entfernen** lässt das unten genannte Datenverzeichnis bestehen. Lösche es, um die lokalen Sync-Daten zu entfernen.
* **Datenverzeichnis:** `~/Library/Application Support/Nordvec Desktop`
* **Logdatei:** `~/Library/Application Support/Nordvec Desktop/logs/nordvec-<date>.log`

## Linux [#linux]

* **Download:** ein AppImage für x64. Es läuft unter deinem Benutzerkonto ohne systemweite Installation.
* **App entfernen** lässt das unten genannte Datenverzeichnis bestehen. Lösche es, um die lokalen Sync-Daten zu entfernen.
* **Schlüsselbund:** Die App benötigt einen laufenden gnome-keyring oder KWallet, um ihre lokalen Sync-Daten zu verschlüsseln, und synchronisiert nicht ohne einen davon.
* **Datenverzeichnis:** `~/.config/Nordvec Desktop`
* **Logdatei:** `~/.config/Nordvec Desktop/logs/nordvec-<date>.log`
* Wenn `XDG_CONFIG_HOME` gesetzt ist, ist das Datenverzeichnis stattdessen `$XDG_CONFIG_HOME/Nordvec Desktop`.

## Was sich im Datenverzeichnis befindet [#was-sich-im-datenverzeichnis-befindet]

Alles, was die App auf deinem Computer speichert, befindet sich im Datenverzeichnis für dein Betriebssystem, wie oben angegeben. Jedes angemeldete Konto hat seinen eigenen Sync-Speicher.

| Name                              | Inhalt                                                                                                                                                                                                                                                                                |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sync-state-<account key>.sqlite` | Der Sync-Speicher für ein angemeldetes Konto: überwachte Ordner, Ausschlüsse, die Upload- und Löschwarteschlangen sowie den Synchronisationsstatus. Dateinamen und Pfade darin sind mit einem Schlüssel verschlüsselt, der durch den Schlüsselbund des Betriebssystems geschützt ist. |
| `logs/nordvec-<date>.log`         | Das App-Log für einen Tag. Es zeichnet Ereignisse, Zählungen und Fehlercodes auf, und jede Zeile nennt die App-Version, die sie geschrieben hat. Es ist so verfasst, dass es keine Dateinamen, Pfade oder Dateiinhalte enthält.                                                       |
| `logs/nordvec-<date>.1.log`       | Der ältere Teil eines Tageslogs, der aufbewahrt wird, wenn das Tageslog seine Größenbegrenzung erreicht. Maximal eines pro Tag.                                                                                                                                                       |
| `window-state.json`               | Die letzte Größe und Position des Fensters.                                                                                                                                                                                                                                           |
| `ui-locale`                       | Die Sprache der letzten Seite, die die App angezeigt hat, damit das Tray-Menü und Benachrichtigungen diese verwenden.                                                                                                                                                                 |
| `update-health.json`              | Wann die App zuletzt nach Updates gesucht hat und ob die Überprüfungen fehlschlagen.                                                                                                                                                                                                  |
| `whats-new-version`               | Die letzte Version, deren Änderungen die App angezeigt hat, sodass die Änderungen jedes Updates nur einmal angezeigt werden.                                                                                                                                                          |
| `first-run-done`                  | Markiert, dass der erste Start ausgeführt wurde, sodass der Start mit Anmeldung nur bei einer Neuinstallation aktiviert wird.                                                                                                                                                         |
| `crash-ledger.json`               | Wann die App zuletzt aufgrund eines Fehlers beendet wurde, nur als Zeitstempel, sodass ein zweiter Stopp kurz nach dem erneuten Öffnen die App geschlossen hält, anstatt sie erneut zu öffnen.                                                                                        |

Während der Sync-Speicher geöffnet ist, verwaltet SQLite die Dateien `-wal`, `-shm`, `-journal` neben `sync-state-<account key>.sqlite`. Sie gehören zum Speicher. Die App speichert außerdem die Cookies und den Site-Speicher der angemeldeten Sitzung im Datenverzeichnis. Der Cookie-Speicher ist mit einem Schlüssel verschlüsselt, den der Schlüsselbund des Betriebssystems schützt.

Auf einem Computer, auf dem ein früher Build ausgeführt wurde, findest du möglicherweise auch:

| Name                                     | Inhalt                                                                                                                                                                                                      |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sync-state.json`                        | Zustand, der von einer frühen Build-Version geschrieben wurde. Bei der Anmeldung übergibt die App ihn an das Konto, dem er gehört, und behält ihn, wenn sie nicht feststellen kann, wem er gehört.          |
| `logs/nordvec.log`                       | Das Log, das eine frühe Build-Version geschrieben hat. Es wird zusammen mit den täglichen Logs gelöscht, sobald es alt genug ist.                                                                           |
| `logs/nordvec.log.old`                   | Das vorherige Log einer frühen Build-Version, das unter denselben Bedingungen gelöscht wird.                                                                                                                |
| `sync-state-<account key>.json`          | Pro-Konto-Zustand, der von einer frühen Build-Version geschrieben wurde. Bei der Anmeldung kopiert die App ihn in den Sync-Speicher und benennt ihn um, sobald die Kopie erfolgreich gelesen wurde.         |
| `sync-state-<account key>.json.imported` | Derselbe frühe Zustand, nachdem seine Inhalte in den Sync-Speicher kopiert wurden. Er enthält unverschlüsselte Dateinamen und Pfade, und nichts liest ihn erneut, sodass er gefahrlos gelöscht werden kann. |

## Logdatei [#logdatei]

Die App schreibt täglich eine Logdatei, `logs/nordvec-<date>.log` im Datenverzeichnis, wobei das Datum der Tag auf deinem Computer ist. Um den Ordner über die App zu öffnen, wähle **Hilfe > Logdatei anzeigen**. Wenn das Tageslog 5 MB erreicht, werden die älteren Zeilen nach `nordvec-<date>.1.log` verschoben, sodass ein Tag maximal zwei Dateien umfasst.

Die App behält die letzten 14 Tage, den heutigen Tag eingeschlossen, und maximal 50 MB an Logs insgesamt. Sie löscht zuerst die ältesten Tage. Sie löscht niemals das heutige Log und löscht nur Dateien mit diesen Namen.

Jede Zeile nennt die Build-Version, die sie geschrieben hat, als `v=<version> sha=<commit>` nach der Uhrzeit und dem Level.

## Welche Version du hast [#welche-version-du-hast]

* Windows: Wähle **Hilfe > Über Nordvec Desktop**.
* macOS: Wähle **Nordvec Desktop > Über Nordvec Desktop**.
* Linux: Wähle **Hilfe > Über Nordvec Desktop**.
* Bei jedem Start schreibt die App außerdem eine Zeile, die mit `app_ready version=` beginnt, in die Logdatei, gefolgt von der Version.

## Problem melden [#problem-melden]

Prüfe zuerst die [bekannten Probleme](/docs/guides/desktop/known-issues). Um einen Fehler zu melden, gib die App-Version und, falls möglich, die Logdatei an. Die App ist so geschrieben, dass sie keine Dateinamen, Pfade oder Dateiinhalte protokolliert. Lies das Log jedoch vor dem Teilen durch und entferne alles, was du nicht weitergeben möchtest.
