Jotter konfigurieren

Du kannst anpassen, wie Jotter ausgeführt wird (z. B. den Netzwerk-Port ändern oder festlegen, wo deine Aufgabendateien gespeichert werden). Dies ist über Kommandozeilenargumente, Umgebungsvariablen oder eine Konfigurationsdatei möglich.

---

Konfigurations-Eigenschaften

Einstellung	CLI-Option	Konfig-Schlüssel	Umgebungsvariable	Standardwert	Beschreibung
Port	--port <nummer>	port: <nummer>	N/A	58271	Der Netzwerk-Port, auf dem der Server lauscht.
Host	--host <adresse>	host: "<adresse>"	N/A	127.0.0.1	Die Host-IP-Adresse, an die sich der Server bindet (z. B. 0.0.0.0, um Zugriff aus dem lokalen Netzwerk zu erlauben).
Log-Verzeichnis	N/A	log_dir: "<pfad>"	JOTTER_LOG_DIR	Siehe Speicherorte	Das Verzeichnis, in dem Jotter die Datei jotter.log speichert. Getrennt von den Notizen, um Git-Konflikte zu vermeiden.
Log-Level	--log-level <level>	log_level: "<level>"	JOTTER_LOG_LEVEL	info (Dev) / warning (Prod)	Detailtiefe der Log-Ausgaben (debug, info, warning, error, critical).
Log-Farben	--no-color	use_colors: false	NO_COLOR / JOTTER_USE_COLORS	true (Auto)	ANSI-Farbausgabe in Terminal-Logs umschalten. Hilfreich, falls ältere Windows-Terminals Escape-Codes ([32m) anzeigen.
Konfig-Datei	--config <pfad> / -c	N/A	N/A	Siehe Speicherorte	Gibt den Pfad zu einer benutzerdefinierten YAML- oder JSON-Konfigurationsdatei an. Wird automatisch erstellt, wenn sie fehlt.

---

Speicherorte

Hinweis: Vaults verwaltest du in der App (Zahnrad neben der Vault-Auswahl); sie werden in vaults.json im Konfigurationsordner gespeichert. Der frühere Konfigurationsschlüssel data_dir, die Umgebungsvariable JOTTER_DATA_DIR und die Option --data-dir werden nicht mehr unterstützt; Schlüssel und Umgebungsvariable werden mit einer Warnung ignoriert.

Eine ./jotter.yaml (oder ./jotter.yml/./jotter.json) im aktuellen Arbeitsverzeichnis wird vor der globalen Konfigurationsdatei gelesen. Nur der erste Vault wird automatisch angelegt, und zwar im Konfigurationsordner; sein Pfad hängt nie vom Arbeitsverzeichnis ab.

Betriebssystem	Standard-Vault	Standard-Konfigurationsdatei	Standard-Log-Verzeichnis
Linux	~/.config/jotter/tasks	~/.config/jotter/jotter.yaml	~/.cache/jotter
macOS	~/Library/Application Support/jotter/tasks	~/Library/Application Support/jotter/jotter.yaml	~/Library/Logs/Jotter
Windows	%APPDATA%\jotter\tasks	%APPDATA%\jotter\jotter.yaml	%LocalAppData%\Jotter

Hinweis: Installationen mit vorhandener vaults.json behalten die dort gespeicherten Vault-Pfade. Lässt sich die vaults.json nicht lesen, bricht Jotter mit einer Fehlermeldung ab und lässt die Datei unverändert, statt einen neuen Standard-Vault anzulegen.

---

Logging & Dual-Writer

Jotter verwendet einen Dual-Writer-Logging-Mechanismus. Das bedeutet, dass alle Log-Ausgaben (Startup-Informationen, Synchronisationsberichte, Git-Aktivitäten und Systemfehler) sowohl auf die Standardausgabe (stdout) ausgegeben als auch an eine persistente lokale Protokolldatei namens jotter.log angehängt werden.

Diese Datei ist von deinem Markdown-Datenverzeichnis isoliert, sodass sie von Jotters automatischen Git-Commits nicht erfasst wird.

Log-Rotation

Um lokalen Speicherplatz zu sparen, begrenzt Jotter die Größe der Datei jotter.log automatisch. Wenn die Datei beim Starten von Jotter größer als 5 MB ist, wird sie gelöscht und ein neues, leeres Log-File angelegt.

---

Automatische Erstellung der Konfiguration

Um die Ersteinrichtung so mühelos wie möglich zu machen, erstellt Jotter automatisch eine vorkonfigurierte Standarddatei, falls am Zielort keine Konfigurationsdatei existiert (entweder am Pfad für die Standard-Konfigurationsdatei oben).

Die erstellte Datei enthält die Parameter als auskommentierte Vorlagen, die sofort angepasst werden können:

# Jotter Configuration File
# log_dir: ""
# host: "127.0.0.1"
# port: 58271
# log_level: "INFO"

---

Priorität der Konfigurationseinstellungen

Jotter wertet die Einstellungen in folgender Reihenfolge aus (höhere Priorität überschreibt niedrigere):

1. Kommandozeilenparameter (z. B. --port 9000)
2. Umgebungsvariablen (z. B. JOTTER_PORT)
3. Geladene Konfigurationsdatei (jotter.yaml/jotter.yml/jotter.json)
4. Standardpfade (Systemspezifische Standardverzeichnisse)

---

Beispiele für die Kommandozeile

• Auf einem benutzerdefinierten Port ausführen:

  jotter --port 8080

• Eine bestimmte Konfigurationsdatei laden:

  jotter --config /etc/jotter/config.yaml

---

Git-Versionierung

Ist der Ordner deines Vaults ein Git-Repository, committet Jotter lokale Änderungen, automatisch kurz nach jeder Änderung (höchstens einmal pro Minute) oder sobald du in der Fußzeile der Seitenleiste auf Commit klickst. Auf diesen Commits baut die Time Machine auf.

Jotter committet ausschließlich lokal. Ein Repository legt es nur an, wenn du auf Git aktivieren klickst, und es führt weder Push noch Pull aus. Details und Hinweise zur Synchronisation über mehrere Geräte findest du unter Git-Versionierung und Time Machine.