Files and logsFichiers et logs
Where xdesk keeps its settings, identity, device registry, audit log and terminal transcripts.Où xdesk garde ses réglages, son identité, son registre d'appareils, son journal d'audit et les transcriptions des terminaux.
xdesk paths prints the three folders of this PC.
xdesk paths affiche les trois dossiers de ce PC.
1. FoldersDossiers
| File | Content |
|---|---|
~/.config/xdesk/config.json | the settings |
~/.config/xdesk/known_hosts.json | hosts pinned by the native clients: fingerprint, device id and secret |
~/.local/share/xdesk/cert.pem, key.pem | the host identity (self-signed ECDSA P-256), new with xdesk --regen-cert |
~/.local/share/xdesk/devices.json, registry.key | trusted / known / banned devices, signed with an HMAC key (0600) |
~/.local/share/xdesk/running.json | the running host (an unclean stop during a remote session is detected at the next start) |
~/.local/share/xdesk/tailscale/ | the certificate of the Tailscale name (tailscale cert) |
~/.local/share/xdesk/logs/ | the audit log and the terminal transcripts |
On Windows the config folder is %LOCALAPPDATA%\xdesk (xdesk paths prints the others).
| Fichier | Contenu |
|---|---|
~/.config/xdesk/config.json | les réglages |
~/.config/xdesk/known_hosts.json | hôtes épinglés par les clients natifs : empreinte, id et secret de l'appareil |
~/.local/share/xdesk/cert.pem, key.pem | l'identité de l'hôte (ECDSA P-256 auto-signé), nouvelle avec xdesk --regen-cert |
~/.local/share/xdesk/devices.json, registry.key | appareils de confiance / connus / bannis, signés avec une clé HMAC (0600) |
~/.local/share/xdesk/running.json | l'hôte en cours (un arrêt brutal pendant une session à distance est détecté au démarrage suivant) |
~/.local/share/xdesk/tailscale/ | le certificat du nom Tailscale (tailscale cert) |
~/.local/share/xdesk/logs/ | le journal d'audit et les transcriptions des terminaux |
Sous Windows, le dossier de config est %LOCALAPPDATA%\xdesk (xdesk paths affiche les autres).
2. Audit logJournal d'audit
logs/audit-<day>.jsonl: one JSON object per line, ts level cat session msg + data: connections, decisions, inputs, terminal commands. The logs page of the panels reads it live (level, category, search, details).
logs/audit-<jour>.jsonl : un objet JSON par ligne, ts level cat session msg + data : connexions, décisions, entrées, commandes des terminaux. La page des logs des panneaux le lit en direct (niveau, catégorie, recherche, détails).
3. Terminal transcriptsTranscriptions des terminaux
logs/terminal-<date>-<session>-<id>.log: everything a remote terminal printed, with the bytes typed. The sessions page mirrors them live.
The registry is checked with its HMAC key at each start: edited outside xdesk, it is refused and every trusted device must pair again.
logs/terminal-<date>-<session>-<id>.log : tout ce qu'un terminal distant a affiché, avec les octets tapés. La page des sessions les reflète en direct.
Le registre est vérifié avec sa clé HMAC à chaque démarrage : modifié hors de xdesk, il est refusé et chaque appareil de confiance doit être réappairé.