timothepoznanski/poznote

Schritt 1: Voraussetzung

Installieren und starten Sie Docker Desktop

Schritt 2: Poznote bereitstellen

Erstellen Sie ein neues Verzeichnis:

mkdir poznote

Wechseln Sie in das Poznote-Verzeichnis:

cd poznote

Erstellen Sie die Umgebungsdatei:

curl -o .env https://raw.githubusercontent.com/timothepoznanski/poznote/main/.env.template

Bearbeiten Sie die Datei .env:

notepad .env

Laden Sie die Docker-Compose-Konfigurationsdatei herunter:

curl -o docker-compose.yml https://raw.githubusercontent.com/timothepoznanski/poznote/main/docker-compose.yml

Laden Sie die neuesten Images für den Poznote-Webserver und Poznote MCP herunter:

docker compose pull

Starten Sie die Poznote-Container:

docker compose up -d

Schritt 1: Voraussetzung

1. Installieren Sie die Docker Engine
2. Installieren Sie Docker Compose

Schritt 2: Poznote installieren

Erstellen Sie ein neues Verzeichnis:

mkdir poznote

Wechseln Sie in das Poznote-Verzeichnis:

cd poznote

Erstellen Sie die Umgebungsdatei:

curl -o .env https://raw.githubusercontent.com/timothepoznanski/poznote/main/.env.template

Bearbeiten Sie die Datei .env:

vi .env

Laden Sie die Docker-Compose-Konfigurationsdatei herunter:

curl -o docker-compose.yml https://raw.githubusercontent.com/timothepoznanski/poznote/main/docker-compose.yml

Laden Sie die neuesten Images für den Poznote-Webserver und Poznote MCP herunter:

docker compose pull

Starten Sie die Poznote-Container:

docker compose up -d

Schritt 1: Voraussetzung

Installieren und starten Sie Docker Desktop

Schritt 2: Poznote bereitstellen

Erstellen Sie ein neues Verzeichnis:

mkdir poznote

Wechseln Sie in das Poznote-Verzeichnis:

cd poznote

Laden Sie die Umgebungsdatei herunter:

curl -o .env https://raw.githubusercontent.com/timothepoznanski/poznote/main/.env.template

Bearbeiten Sie die Datei .env:

vi .env

Laden Sie die Docker-Compose-Konfigurationsdatei herunter:

curl -o docker-compose.yml https://raw.githubusercontent.com/timothepoznanski/poznote/main/docker-compose.yml

Laden Sie die neuesten Images für den Poznote-Webserver und Poznote MCP herunter:

docker compose pull

Starten Sie die Poznote-Container:

docker compose up -d

Sie möchten keinen Server verwalten? Ein Hosting-Anbieter kann Poznote für Sie betreiben und online halten. Die verfügbaren Anbieter und wie Sie zwischen ihnen wählen, finden Sie hier.

Auf einem Proxmox-VE-Host installiert das Projekt Proxmox VE Community Scripts Poznote mit einem einzigen Befehl in einem eigenen Container, ganz ohne Docker: Es erstellt einen unprivilegierten Debian-13-LXC (standardmäßig 1 vCPU, 512 MB RAM und 4 GB Festplatte) und stellt Poznote darin über nginx und PHP bereit.

Führen Sie dies in der Shell des Proxmox-Hosts aus:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/poznote.sh)"

Poznote ist dann unter http://<container-ip>:8040 erreichbar, mit denselben Standard-Zugangsdaten wie bei jeder anderen Installation. Um später zu aktualisieren, führen Sie update in der Konsole des Containers aus.

Dieses Skript wird von der Community geschrieben und gepflegt, nicht von Poznote. Optionen und Hinweise finden Sie auf der Seite des Poznote-Skripts.

Schritt 1: Voraussetzung

Installieren Sie Helm und stellen Sie sicher, dass Ihr Kubernetes-Kontext auf den Cluster zeigt, in dem Sie Poznote bereitstellen möchten.

Schritt 2: Poznote bereitstellen

Fügen Sie das HelmForge-Chart-Repository hinzu:

helm repo add helmforge https://repo.helmforge.dev

Aktualisieren Sie Ihren lokalen Chart-Index:

helm repo update

Installieren Sie Poznote:

helm install poznote helmforge/poznote --namespace poznote --create-namespace

Das Poznote-Helm-Chart wird von der HelmForge-Community als Kubernetes-native Installationsoption gepflegt. Werte, Persistenz, Service-Freigabe, Probes, Security Contexts und weitere produktionsrelevante Einstellungen sind in der Dokumentation des HelmForge-Charts für Poznote beschrieben.

Poznote liefert außerdem eine Rootless-Variante des Images, die vollständig als unprivilegierter Benutzer (uid/gid 1000) statt als root läuft. Sie ist für Umgebungen gedacht, die root in Containern verbieten (Kubernetes mit restriktivem PodSecurityStandard, rootless Podman, docker run --user usw.). Sie funktioniert genau wie das Standard-Image, mit nur zwei Unterschieden: Sie lauscht intern auf Port 8080 und kann die Eigentümerschaft Ihres Datenverzeichnisses beim Start nicht selbst korrigieren.

Schritt 1: Voraussetzung

1. Installieren Sie die Docker Engine
2. Installieren Sie Docker Compose

Schritt 2: Poznote bereitstellen

Erstellen Sie ein neues Verzeichnis:

mkdir poznote

Wechseln Sie in das Poznote-Verzeichnis:

cd poznote

Erstellen Sie das Datenverzeichnis und übertragen Sie die Eigentümerschaft an uid/gid 1000 (erforderlich: Anders als das Standard-Image kann der Rootless-Container diese Eigentümerschaft beim Start nicht selbst korrigieren):

mkdir -p data
sudo chown -R 1000:1000 data

sudo ist hier oft nicht nötig: Wenn Ihr Benutzer bereits die uid 1000 hat, können Sie chown überspringen, und unter rootless Podman/Docker funktioniert es auch ohne root, siehe Rootless-Betrieb.

Erstellen Sie die Umgebungsdatei:

curl -o .env https://raw.githubusercontent.com/timothepoznanski/poznote/main/.env.template

Bearbeiten Sie die Datei .env:

vi .env

Laden Sie die Rootless-Docker-Compose-Konfigurationsdatei herunter:

curl -o docker-compose.rootless.yml https://raw.githubusercontent.com/timothepoznanski/poznote/main/docker-compose.rootless.yml

Laden Sie die neuesten Rootless-Images für den Poznote-Webserver und Poznote MCP herunter:

docker compose -f docker-compose.rootless.yml pull

Starten Sie die Poznote-Container:

docker compose -f docker-compose.rootless.yml up -d

Wie Sie eine bestehende Poznote-Instanz auf die Rootless-Variante umstellen und weitere Details finden Sie unter Rootless-Betrieb im Leitfaden zur Fehlerbehebung.

• HTTP_WEB_PORT
• POZNOTE_OIDC_CLIENT_ID
• POZNOTE_OIDC_CLIENT_SECRET
• POZNOTE_OIDC_DISABLE_NORMAL_LOGIN
• Optionale Laufzeit-Überschreibungen wie POZNOTE_MCP_PORT und POZNOTE_DEBUG
• POZNOTE_PHP_FPM_MAX_CHILDREN, um auf einer stark ausgelasteten Instanz die Anzahl gleichzeitiger PHP-Anfragen zu ändern (Standard 10), siehe Leitfaden zur Fehlerbehebung
• POZNOTE_PHP_MEMORY_LIMIT, um das PHP-Speicherlimit pro Anfrage in MB zu ändern (Standard 512), siehe Leitfaden zur Fehlerbehebung
• POZNOTE_LISTEN_PORT, um den Port zu ändern, auf dem der Webserver im Container lauscht (Standard 80), nur mit network_mode: host nötig, siehe Leitfaden zur Fehlerbehebung
• POZNOTE_SETTINGS_PASSWORD, um vor dem Öffnen der Einstellungsseite ein zusätzliches Passwort abzufragen, standardmäßig leer
• POZNOTE_MCP_AUTH_TOKEN, um von MCP-Clients ein Bearer-Token zu verlangen, siehe MCP-Server

• Administrative und globale Einstellungen wie OIDC-Anbietereinstellungen, Aktivierung der Git-Synchronisierung, Importlimits und das Hochladen von benutzerdefiniertem CSS
• Benutzer- und Profileinstellungen wie Passwörter lokaler Konten, Design, Schriftgrößen, Sortierung der Notizen, Hintergrund des Arbeitsbereichs und ausgeblendete Oberflächenelemente

Poznote authentifiziert Benutzer anhand ihres Profils mit einem Benutzernamen oder einer E-Mail-Adresse und einem Passwort.

Standardkonto

Bei einer Neuinstallation legt Poznote ein aktives Administratorprofil an:

• Benutzername: admin_change_me
• Passwort: admin

Ändern Sie das Standardpasswort und benennen Sie das Konto nach der ersten Anmeldung um.

Passwortverwaltung

Passwörter werden über die Poznote-Weboberfläche verwaltet, nicht über .env:

• Benutzer können ihr eigenes Passwort unter Einstellungen > Passwort ändern ändern.
• Administratoren können unter Einstellungen > Admin-Werkzeuge > Benutzerverwaltung für jeden Benutzer ein eigenes Passwort festlegen oder es auf den Standardwert zurücksetzen.
• Die Option 30 Tage merken hält die Sitzung 30 Tage lang aufrecht.
• Eine Passwortänderung macht die bestehenden „Merken“-Cookies dieses Benutzers ungültig.

Zwei-Faktor-Authentifizierung

Jeder Benutzer kann die Zwei-Faktor-Authentifizierung (TOTP) unter Settings > Two-factor authentication aktivieren. Nach dem Passwort verlangt das Anmeldeformular dann einen 6-stelligen Code aus einer Authenticator-App (Aegis, Google Authenticator, 1Password, Bitwarden...).

• Die Einrichtung zeigt einen im Browser gezeichneten QR-Code und zehn einmalig verwendbare Wiederherstellungscodes, die für den Fall eines verlorenen Telefons aufzubewahren sind.
• Sie schützt die Anmeldung mit Passwort. Eine SSO-Anmeldung bleibt Sache des Identitätsanbieters und seines eigenen zweiten Faktors.
• Solange sie aktiv ist, akzeptiert die REST-API das Kontopasswort allein nicht mehr: Geben Sie Clients ein App-Passwort oder senden Sie den aktuellen Code im Header X-Poznote-OTP.
• Ein Administrator kann sie für einen Benutzer deaktivieren, der sowohl sein Gerät als auch seine Wiederherstellungscodes verloren hat, unter Settings > Admin Tools > User Management (Passwortdialog).
• Ein Administrator kann sie unter Settings > Admin Tools > Require two-factor für jedes Konto, das sich mit einem Passwort anmeldet, verpflichtend machen. Ein Konto ohne sie richtet sie bei der nächsten Anmeldung ein (QR-Code und erster Code auf der Anmeldeseite), ohne sie geöffnete Sitzungen werden beendet, und der Inhaber kann sie nicht mehr deaktivieren. SSO-Anmeldungen sind nicht betroffen.
• Das Aktivieren oder Deaktivieren macht bestehende Remember-me-Cookies dieses Benutzers ungültig.

Standardpasswörter

• Administratorkonten: admin
• Standardbenutzerkonten: user

Solange ein Benutzer sein Passwort noch nicht geändert hat, gilt der oben genannte Standardwert. Sobald ein Passwort über die Oberfläche geändert wurde, wird ein sicherer bcrypt-Hash in der Datenbank gespeichert, der Vorrang hat.

Poznote unterstützt OpenID Connect (Authorization Code + PKCE) für Single Sign-on. Damit können sich Benutzer über externe Identitätsanbieter wie Auth0, Keycloak, Azure AD oder Google Identity anmelden.

Funktionsweise

1. Ist OIDC aktiviert, zeigt die Anmeldeseite eine Schaltfläche Weiter mit [Anbietername] an.
2. Benutzer authentifizieren sich über den OIDC-Authorization-Code-Flow, abgesichert durch PKCE.
3. Der Zugriff lässt sich über erlaubte Gruppen und bei Bedarf über eine ältere Liste erlaubter Benutzer einschränken.
4. Nach der Authentifizierung verknüpft Poznote die Identität über sub (oidc_subject), dann über eine verifizierte E-Mail (von einem Admin gesetzt oder vom Anbieter synchronisiert, Groß-/Kleinschreibung egal). Ein bestehendes Profil wird nie über seinen Benutzernamen verknüpft: Damit es bei der ersten SSO-Anmeldung verknüpft wird, trage in Settings > Admin Tools > User Management die E-Mail ein, die der Anbieter sendet, oder füge seinen OIDC-Subject ein. Eine abgelehnte erste Anmeldung schreibt den einzufügenden Subject ins Log.
5. Ist das automatische Anlegen von Benutzern aktiviert und passt kein Profil, legt Poznote automatisch eines an. Ein solches Profil hat überhaupt kein Passwort: Es hat nie die Übergabe der initialen Zugangsdaten durchlaufen, die ein Administrator beim Anlegen eines Kontos vornimmt, und reagiert daher nicht auf das Standardpasswort. Die Anmeldung erfolgt über den Anbieter, oder ein Administrator legt unter Einstellungen > Admin-Werkzeuge > Benutzerverwaltung ein ausdrückliches Passwort fest.
6. Mit POZNOTE_OIDC_DISABLE_NORMAL_LOGIN=true wird das Formular für Benutzername und Passwort ausgeblendet, und die Anmeldeseite erlaubt nur noch SSO.
7. Bei aktiviertem OIDC können sich REST-API-Clients mit Authorization: Bearer <OIDC JWT> authentifizieren. Poznote prüft dabei die JWKS des Anbieters, den Aussteller, das Ablaufdatum, die Audience und die konfigurierten Zugriffsbeschränkungen.
8. Clients, die überhaupt keinen OIDC-Flow durchlaufen können (Browsererweiterung, mobile App, Skripte), verwenden stattdessen ein App-Passwort, das jeder Benutzer in seinen eigenen Einstellungen erstellt.
9. Die Zwei-Faktor-Authentifizierung gilt nur für das Passwortformular: Eine SSO-Anmeldung fragt nie nach dem Poznote-Code. Verlangen Sie den zweiten Faktor stattdessen im Identitätsanbieter. Ein Benutzer mit Passwort und SSO-Identität behält beide Zugänge, und der Zugang über SSO ist nur so stark wie die Richtlinie des Anbieters.

Konfiguration

OIDC wird in der Administrationsoberfläche konfiguriert: Öffnen Sie Einstellungen > Admin-Werkzeuge > OIDC / SSO.

Die meisten Einstellungen (Aktivierung, Aussteller, Anbietername, Scopes, Zugriffskontrolle, erlaubte Gruppen/Benutzer, automatisches Anlegen von Benutzern, Verhalten von HTTP Basic Auth usw.) werden auf dieser Seite verwaltet und in der Datenbank gespeichert.

Für die Bearer-JWT-Authentifizierung an der REST-API konfigurieren Sie JWT-Audience der API, wenn Ihr Anbieter Access Tokens für eine eigene API-Audience ausstellt. Ist das Feld leer, akzeptiert Poznote die konfigurierte OIDC-Client-ID als JWT-Audience.

Die folgenden Einstellungen verbleiben in der Datei .env:

POZNOTE_OIDC_CLIENT_ID=your_client_id
POZNOTE_OIDC_CLIENT_SECRET=your_client_secret
POZNOTE_OIDC_DISABLE_NORMAL_LOGIN=false

Verwenden Sie POZNOTE_OIDC_DISABLE_NORMAL_LOGIN=true, wenn Sie das lokale Formular für Benutzername und Passwort ausblenden und nur die Anmeldung per SSO zulassen möchten. Dies ist der einzige Schalter, der die Passwort-Authentifizierung sperrt: Er entfernt das Formular, lehnt Passwort-POSTs serverseitig ab und blendet die Einstellung „Passwort ändern“ aus.

Wiederherstellung nach einem Ausfall des Identitätsanbieters. Nur SSO bedeutet genau das: Solange POZNOTE_OIDC_DISABLE_NORMAL_LOGIN=true gesetzt ist, kann sich niemand mit einem Passwort anmelden, auch keine Administratoren, und es gibt keinen Notausgang im Browser. Das ist Absicht, denn so kann ein Angreifer, der ein Administratorkonto übernommen hat, die Passwort-Anmeldung nicht wieder aktivieren, um sich dauerhaften Zugang zu verschaffen. Für die Wiederherstellung ist Serverzugriff nötig: Setzen Sie POZNOTE_OIDC_DISABLE_NORMAL_LOGIN=false in .env, starten Sie den Container neu und melden Sie sich mit einem lokalen Passwort an. Stellen Sie vor dem Aktivieren von Nur-SSO sicher, dass mindestens ein Administratorkonto ein ausdrücklich festgelegtes Passwort hat (Einstellungen > Admin-Werkzeuge > Benutzerverwaltung), sonst hilft auch das Zurücksetzen des Schalters nicht. Beachten Sie, dass ein automatisch per OIDC angelegtes Administratorprofil kein Passwort hat, solange keines festgelegt wurde.

Inkompatible Änderung: Frühere OIDC-Einstellungen in .env werden nicht mehr gelesen, mit Ausnahme von POZNOTE_OIDC_CLIENT_ID, POZNOTE_OIDC_CLIENT_SECRET und POZNOTE_OIDC_DISABLE_NORMAL_LOGIN. Geben Sie die übrigen OIDC-Einstellungen nach dem Upgrade auf der Administrationsseite erneut ein.

URLs, die beim Identitätsanbieter einzutragen sind

Wenn Sie die Anwendung (den Client) bei Ihrem Identitätsanbieter anlegen, tragen Sie die erste URL unten als Redirect-URI (auch Callback-URL genannt) ein und die zweite als Post-Logout-Redirect-URI, falls Ihr Anbieter danach fragt:

https://YOUR_SERVER/oidc_callback.php
https://YOUR_SERVER/login.php

Poznote bildet beide aus dem Hostnamen, über den die Anfrage eintrifft, immer mit https://. Braucht Ihr Anbieter etwas anderes, setzen Sie Redirect-URI oder Post-Logout-Redirect-URI im Abschnitt Erweitert der OIDC-Administrationsseite und tragen Sie genau diesen Wert ein.

Die Discovery-URL muss in der Regel nicht ausgefüllt werden: Poznote hängt /.well-known/openid-configuration an die Issuer-URL an. Bei Authentik lautet der Issuer zum Beispiel https://AUTHENTIK_HOST/application/o/APPLICATION_SLUG/. Setzen Sie Discovery-URL nur, wenn Ihr Anbieter dieses Dokument an anderer Stelle veröffentlicht.

Beispiel für Zugriffskontrolle (Gruppen + automatisches Anlegen)

Konfigurieren Sie auf der OIDC-Administrationsseite:

• Groups-Claim: groups
• Erlaubte Gruppen: poznote
• Benutzerprofile bei der ersten OIDC-Anmeldung automatisch erstellen: aktiviert

Ist das automatische Anlegen aktiviert, erzeugt Poznote einen Benutzernamen aus den OIDC-Claims (preferred_username, nickname, lokaler Teil der E-Mail-Adresse, name, dann sub) und speichert das OIDC-Subject im angelegten Profil. Trägt ein bestehendes Profil, das sich noch nie per SSO angemeldet hat, bereits diesen preferred_username, wird die Anmeldung abgelehnt, statt daneben ein zweites Profil anzulegen: Trage bei diesem Profil die E-Mail ein, die der Anbieter sendet, oder seinen OIDC-Subject, damit es verknüpft wird.

• Editor: Direkte WYSIWYG-Bearbeitung (What You See Is What You Get).
• Speicherung: Als .html-Dateien im Datenverzeichnis des Benutzers gespeichert. Da es sich um Standard-HTML handelt, lassen sie sich direkt in jedem Webbrowser öffnen.
• Exklusive Funktionen:
  • Umfangreiche Formatierung: Native Unterstützung für Textfarben, Hervorhebungen und Standard-HTML-Elemente.
  • Interaktive Oberfläche: Elemente lassen sich direkt im Editor bearbeiten.

• Editor: Editor für Markdown-Syntax mit Echtzeit-Vorschau.
• Speicherung: Als .md-Dateien im Datenverzeichnis des Benutzers gespeichert.
• Exklusive Funktionen:
  • Mermaid-Diagramme: Native Unterstützung für die Erzeugung von Diagrammen (Flussdiagramme, Sequenzdiagramme usw.) über ```mermaid-Codeblöcke.
  • Mathematische Formeln: Zuverlässige LaTeX-Unterstützung für mathematische Formeln mit der Syntax $ inline $ und $$ block $$.
  • Portabilität: Standard-Markdown-Format, kompatibel mit jedem externen Editor oder Static-Site-Generator.

• Verwendung: Verwalten Sie Aufgaben und Projekte mit interaktiven Checklisten.
• Arbeitsablauf: Verfolgen Sie den Fortschritt mit Kontrollkästchen, die sich direkt im Editor oder in der Notizliste abhaken lassen. Ein Fortschrittsbalken zeigt, wie weit jede Liste erledigt ist.
• Aufgabenoptionen: Jede Aufgabe kann ein Fälligkeitsdatum mit optionaler Uhrzeit, eine Erinnerung, die zum Fälligkeitszeitpunkt ausgelöst wird, und eine Priorität (hoch, mittel oder niedrig, in Rot, Orange oder Grün) erhalten und lässt sich in eine andere Liste verschieben.
• Aufgaben-Seite: Eine eigene Seite Aufgaben, die Sie über die linke Symbolleiste öffnen, sammelt an einem Ort alle Aufgaben Ihrer Aufgabenlisten und auf Wunsch auch die Kontrollkästchen in gewöhnlichen Notizen. Sie bietet Statusfilter (Offen, Priorität, Überfällig, Mit Datum, Erledigt), einen Textfilter und eine Kalenderansicht der Aufgaben mit Fälligkeitsdatum. Eine Aufgabenliste oder die Kontrollkästchen einer Notiz lassen sich mit der Augen-Schaltfläche in ihrer Kopfzeile auf der Seite ausblenden und mit Ausgeblendete Listen anzeigen wieder einblenden. Diese Auswahl wird in Ihrem Konto gespeichert und gilt daher auf allen Ihren Geräten.
• Öffentliche Zusammenarbeit: Aufgabenlisten können über eine öffentliche URL geteilt werden. Wurden Bearbeitungsrechte vergeben, können externe Mitwirkende Einträge abhaken, ohne ein Poznote-Konto zu benötigen.

• Funktion: Erstellt an einem anderen Ort einen Verweis auf eine bestehende Notiz.
• Anwendungsfall: Eine Notiz kann so an zwei Stellen gleichzeitig referenziert werden. Beispielsweise kann eine Notiz in einem Ablageordner liegen, während ihre Verknüpfung auf einem Kanban-Board zur aktiven Nachverfolgung erscheint.

• Funktion: Verwenden Sie vorformulierte Inhalte wieder, um Ihre Dokumentation zu vereinheitlichen, von der vollständigen Notiz bis zum kurzen Textbaustein.
• Einrichtung: Legen Sie die Notizen, die Sie wiederverwenden möchten, in einen Ordner namens Templates (Unterordner sind erlaubt). Ein Arbeitsbereich namens Templates funktioniert ebenfalls und steht in jedem Arbeitsbereich zur Verfügung. Der Name wird auch in der Sprache der Oberfläche erkannt (Modèles, Vorlagen, Plantillas, Modelos, Шаблоны, 模板, 템플릿, テンプレート).
• In eine Notiz einfügen: Tippen Sie in einer Rich-Text- oder Markdown-Notiz /template (oder / gefolgt vom Titel der Vorlage) und wählen Sie eine Vorlage aus: Ihr Inhalt wird an der Cursorposition eingefügt und umgewandelt, falls Vorlage und Notiz nicht vom selben Typ sind.
• Neue Notiz aus einer Vorlage: Duplizieren Sie die Vorlagennotiz, oder duplizieren Sie einen ganzen Templates-Ordner, um ein Projekt mit einer fertigen Ordnerstruktur zu beginnen.

• Verwendung: Schreiben Sie wie in einem Tagebuch eine Notiz pro Tag, über ein eigenes Tagebuch-Board.
• Arbeitsablauf: Die Schaltfläche „Heutigen Eintrag erstellen“ legt die Notiz des heutigen Tages an (sobald sie existiert, heißt sie „Zum heutigen Eintrag“). Sie trägt das aktuelle Datum als Titel und wird automatisch in einer Ordnerstruktur Diary/YYYY/MM abgelegt.
• Ein anderer Tag: Die Kalender-Schaltfläche neben den Ansichtsoptionen wählt einen beliebigen Tag aus, auch auf dem Smartphone. Tage mit einem Eintrag sind mit einem Punkt markiert; die Auswahl eines solchen Tages öffnet seinen Eintrag, jeder andere Tag erhält einen neuen Eintrag mit diesem Datum.
• Board-Ansicht: Einträge werden als Karten angezeigt, nach Monat gruppiert und die neuesten zuerst, mit einem Filter, um frühere Einträge schnell zu finden.
• Journalansicht: Die Schriftrollen-Schaltfläche neben den Ansichtseinstellungen wechselt zu einer einzigen Lesespalte: jeder Eintrag mit seinem vollständigen Inhalt, die neuesten zuerst, nachgeladen beim Scrollen. Der Filter wirkt auch hier. Ein Klick auf einen Eintrag oder seinen Stift bearbeitet ihn direkt an Ort und Stelle; Änderungen werden beim Tippen gespeichert. Die Tag-Schaltfläche neben dem Stift macht die Tags des Eintrags bearbeitbar: Tags hinzufügen oder entfernen, ohne die Notiz zu öffnen.
• Format: Neue Einträge werden als Rich-Text- oder Markdown-Notizen angelegt, je nach der Einstellung „Format der Tagebucheinträge“ unter Einstellungen > Verhalten.

• Verlauf: Die linke Spalte listet die Versionen der Notiz nach Tagen gruppiert auf, jede mit ihrer Art: Automatisch, Manuell, Vor KI-Änderung oder Vor MCP-Änderung. Das Abzeichen „Aktuell“ kennzeichnet die Versionen, die mit der aktuellen Notiz identisch sind, „Unverändert“ die, die mit der Version davor identisch sind. Beide Abzeichen setzen auch denselben Titel und dieselben Tags voraus.
• Inhalt: Die Seite öffnet sich auf diesem Reiter, der die ausgewählte Version selbst gerendert anzeigt. Bei Markdown-Notizen sitzt ein Umschalter Vorschau/Quelltext neben den Reitern.
• Änderungen: Der zweite Reiter zeigt einen zeilenweisen Vergleich mit hervorgehobenen geänderten Wörtern, wahlweise gegenüber der aktuellen Version, der vorherigen Version oder einer beliebigen anderen Version. Der Vergleich wird Einspaltig oder Nebeneinander angezeigt, unveränderte Zeilen werden eingeklappt (per Klick aufklappbar), die Schaltflächen für die vorherige und nächste Änderung springen von einer Änderung zur nächsten, und die Anzahl der hinzugefügten und entfernten Zeilen wird angezeigt. Markdown-Notizen werden anhand ihres Quelltexts verglichen. Rich-Text-Notizen werden anhand ihres Textes verglichen, eine reine Formatierungsänderung ist also nicht zu sehen. Über dem Vergleich zeigt der Reiter die Titeländerung (alt → neu) sowie die Tags, die zwischen den beiden verglichenen Versionen hinzugefügt oder entfernt wurden.
• Aktionen: Das Menü „Aktionen“ enthält „Diese Version wiederherstellen“, „Version speichern“, „Inhalt kopieren“ und „Diese Version löschen“. „Version speichern“ speichert sofort den aktuellen Inhalt, die übrigen Einträge wirken auf die ausgewählte Version.
• Wiederherstellen: Eine Wiederherstellung gibt der Notiz den Inhalt, den Titel und die Tags der Version zurück. Der Stand, den sie ersetzt, wird nicht gespeichert: Ist er wichtig, speichern Sie vorher eine Version („Version speichern“ im Menü Aktionen oder Strg + Alt + S). Ein wiederhergestellter Titel folgt den Regeln für das Umbenennen: Trägt bereits eine andere Notiz im selben Ordner diesen Titel, wird ein Zusatz wie „(1)“ angehängt. Eine Version, die gespeichert wurde, bevor Tags erfasst wurden, enthält keine Tags und lässt die Tags der Notiz unverändert.

• Automatisch: Poznote speichert eine Version, wenn eine Notiz geändert wird, nicht wenn sie geöffnet wird. Jedes Mal, wenn eine Änderung am Inhalt, am Titel oder an den Tags gespeichert wird (automatisches Speichern des Editors, abgehakte Aufgabe, gespeicherte Zeichnung, REST-API, Bearbeitung über einen öffentlichen Freigabelink), bewahrt Poznote zuerst die Notiz so auf, wie sie unmittelbar vor dieser Änderung war, es sei denn, in den letzten 10 Minuten wurde bereits eine Version dieser Notiz angelegt. Eine Version enthält also immer den Stand vor einer Änderung, und eine Bearbeitungssitzung erzeugt höchstens eine automatische Version alle 10 Minuten. Das Öffnen oder Lesen einer Notiz erzeugt nie eine Version. Für eine leere Notiz wird nichts gespeichert, ebenso wenig, wenn die neueste Version bereits genau den aktuellen Inhalt, Titel und die aktuellen Tags enthält: Der Verlauf enthält also keine Duplikate. Diese Versionen sind im Verlauf mit „Automatisch“ gekennzeichnet, ebenso wie die Versionen, die ältere Poznote-Versionen beim Öffnen einer Notiz angelegt haben: Für sie gelten dieselben Regeln.
• Beispiel: Sie bearbeiten eine Notiz von 9:00 bis 9:35 Uhr. Der Verlauf erhält Versionen von etwa 9:00 Uhr (die Notiz, bevor Sie sie angefasst haben), 9:10, 9:20 und 9:30 Uhr. Um 14:00 Uhr kommen Sie zurück und ändern ein Wort: Eine Version von 14:00 Uhr bewahrt die Notiz so auf, wie Sie sie um 9:35 Uhr verlassen haben.
• Wohin Sie zurückkehren können: Der Stand, in dem Sie eine Notiz am Ende einer Sitzung zurücklassen, wird in diesem Moment nicht als Version gespeichert, denn er ist die Notiz selbst. Er wird durch die erste Änderung der nächsten Sitzung festgehalten, wie viel später diese auch stattfindet. Sie können also immer zu dem Stand zurückkehren, den die Notiz hatte, bevor Sie heute mit dem Bearbeiten begonnen haben, und innerhalb einer langen Sitzung zu Ständen, die höchstens etwa 10 Minuten auseinanderliegen. Der neueste Stand ist immer die Notiz selbst: Vergleichen Sie eine beliebige Version mit „Aktuelle Version“, um zu sehen, was sich seitdem geändert hat.
• Aufbewahrungsdauer automatischer Versionen: Alle automatischen Versionen der letzten 24 Stunden werden aufbewahrt. Nach 24 Stunden bleibt nur die neueste automatische Version jedes Tages erhalten, standardmäßig 30 Tage lang. Diese Anzahl von Tagen lässt sich unter Einstellungen > Versionen ändern (1 bis 30). Falls Sie diese Einstellung bereits in einer älteren Version geändert hatten, in der sie Versionen zählte, bleibt Ihr Wert erhalten und zählt nun Tage.
• Manuell: „Version speichern“ fügt jederzeit eine Version hinzu, ebenso Strg + Alt + S (Cmd + Alt + S auf dem Mac) bei geöffneter Notiz. Manuelle Versionen sind unbegrenzt und werden nie ausgedünnt: Sie verschwinden erst, wenn sie nach 30 Tagen ablaufen.
• Vor einer KI-Änderung: Unmittelbar bevor der KI-Assistent oder der MCP-Server den Inhalt einer Notiz ändert, wird automatisch eine Version gespeichert, auch wenn weniger als 10 Minuten zuvor bereits eine automatische Version angelegt wurde, sodass sich eine misslungene Umformulierung mit einem Klick rückgängig machen lässt. Diese Versionen sind im Verlauf mit „Vor KI-Änderung“ oder „Vor MCP-Änderung“ gekennzeichnet und werden übersprungen, wenn die letzte Version bereits denselben Inhalt, denselben Titel und dieselben Tags enthält.
• Sicherheitsversionen: Die Versionen „Vor KI-Änderung“ und „Vor MCP-Änderung“ teilen sich eine gemeinsame Grenze: Pro Notiz werden die 20 neuesten aufbewahrt, eine Anzahl, die Sie unter Einstellungen → Versionen ändern können (1 bis 200), falls auf Ihrer Instanz viele Notizen über KI oder MCP bearbeitet werden.
• Ablauf: Jede Version, gleich welcher Art, wird 30 Tage nach ihrer Erstellung gelöscht. Eine Version kann auch von Hand auf der Seite Versionen gelöscht werden.
• Anhänge und Bilder: Versionen speichern den Text, den Titel und die Tags der Notiz, nie ihre Dateien. Anhänge werden nie kopiert, sodass eine Datei, auf die mehrere Versionen verweisen, nur einmal auf der Festplatte existiert. Eine aus einer Notiz entfernte Datei bleibt, für die Notiz unsichtbar, auf der Festplatte, solange noch eine Version sie enthält, sodass sie beim Wiederherstellen dieser Version zurückkehrt. Endgültig gelöscht wird sie, sobald die letzte Version, die sie enthält, abläuft oder gelöscht wird, oder wenn die Notiz endgültig gelöscht wird. Mehr Versionen aufzubewahren dupliziert also nie Dateien. Entfernte Dateien bleiben lediglich länger erhalten, höchstens 30 Tage.
• API und MCP: Die REST-API und die Werkzeuge des MCP-Servers nennen Versionen weiterhin „Snapshots“ (/notes/{id}/snapshots, list_snapshots, get_snapshot, restore_snapshot).

Unter Einstellungen > Anzeige können Sie Folgendes konfigurieren:

• App-Schriftart: die Schrift für die gesamte Oberfläche wählen
• Schriftgröße: die Textgröße für Notizen, Seitenleiste, Codeblöcke und die Einstellungsseite anpassen
• Notizfarben: die Palette wählen, die beim Einfärben einer Notiz angeboten wird
• Symbole nach Notiztyp: Aufgabenlisten und Markdown-Notizen in der Notizliste ein eigenes Symbol geben
• Skalierung der Index-Symbole: die Größe der Symbole im Notizindex ändern
• Reihenfolge der Icon-Seitenleiste: die Schaltflächen der linken Symbolleiste neu anordnen und ihre Farbe ändern (ein Rechtsklick auf eine Schaltfläche der Leiste öffnet ebenfalls die Farbauswahl)
• Breite des Notizinhalts: die maximale Breite des Notizeditors festlegen
• Anhangsvorschauen: Anhänge als Vorschau in der Notiz anzeigen
• Standard-Bildrahmen: eingefügte Bilder ohne zusätzlichen Innenabstand einrahmen
• Aktuellen Ordnerbaum hervorheben: Notizen und Ordner außerhalb der Ordnerhierarchie, in der Sie gerade arbeiten, abblenden
• Login-Seiten-Titel: den auf der Anmeldeseite angezeigten Titel ändern
• Sichtbarkeit von Elementen: nicht genutzte Oberflächenelemente ausblenden, siehe unten

Unter Einstellungen > Verhalten können Sie Folgendes konfigurieren:

• Notizen-Sortierreihenfolge: festlegen, wie Notizen in der Liste sortiert werden
• Altersfilter für Notizen: nur Notizen auflisten, die innerhalb der gewählten Anzahl von Tagen geändert wurden
• Versionen: wie viele Tage automatische Versionen aufbewahrt werden (eine pro Tag jenseits der letzten 24 Stunden) und wie viele Sicherheitsversionen pro Notiz aufbewahrt werden
• Einfüge-Reihenfolge der Aufgaben: festlegen, wo neue Aufgaben eingefügt werden
• Notizen nach Ordnern anzeigen: Notizen ohne Ordner unterhalb der Ordnerliste anzeigen
• Codeblock-Zeilenumbruch: den Zeilenumbruch in Codeblöcken ein- oder ausschalten
• Format der Tagebucheinträge: Tagebucheinträge als Rich-Text- oder Markdown-Notizen anlegen
• Sprache der Oberfläche, Zeitzone und Datumsformat, Anhänge und Backlinks am Ende einer Notiz, Rechtschreibprüfung und die Tastenkürzel

Unter Einstellungen > Markdown können Sie die Standardansicht, die Schriftart des Editors, Markdown mit Rahmen und farbiges Markdown sowie die Codeblock-Zeilennummern konfigurieren.

Das Design ist hier keine eigene Karte: Die Schaltfläche unten in der linken Symbolleiste schaltet der Reihe nach durch die Designs, und ein Administrator legt unter Einstellungen > Admin-Werkzeuge > Theme-Liste fest, welche sie anbietet.

Sie können für jeden Arbeitsbereich ein Hintergrundbild festlegen: Öffnen Sie Einstellungen > Arbeitsbereiche und verwenden Sie die Aktion Hintergrund des Arbeitsbereichs, um ein Bild hochzuladen und seine Deckkraft einzustellen. So erhält jeder Arbeitsbereich sein eigenes Erscheinungsbild.

Mit Poznote können Sie die Oberfläche entrümpeln, indem Sie Elemente ausblenden, die Sie nicht verwenden.

Konfigurieren Sie dies unter Einstellungen > Anzeige > Sichtbarkeit von Elementen.

• Feine Steuerung: Schalten Sie die Sichtbarkeit von Karten der Startseite, Aktionen der Werkzeugleiste, Einträgen des Slash-Menüs und mehr um. Auch das Abzeichen mit dem Erstellungsdatum an Notizen (Erstellungsdatum der Notiz anzeigen) und die Anzahl der Notizen neben jedem Ordner (Ordner-Notizzähler anzeigen) werden hier ein- und ausgeschaltet.
• Pro Benutzer: Jeder Benutzer kann seine eigene Oberflächengestaltung haben.
• Administratoren: Derselbe Dialog zeigt neben der eigenen Spalte „Ich“ des Administrators eine zweite Spalte „Benutzer“, um Elemente für alle Benutzer der Instanz auszublenden (Administratoren ausgenommen).
• Durchsuchbar: Mit dem Filter im Konfigurationsdialog finden Sie das auszublendende Element schnell.

Poznote wird mit Inter ausgeliefert und kann die auf Ihrem Gerät installierten Schriftarten verwenden. Um eine beliebige andere Schriftart zu nutzen, zum Beispiel eine Familie von Google Fonts, lädt ein Administrator ihre Dateien einmal hoch, danach kann jeder Benutzer sie auswählen.

Laden Sie sie unter Einstellungen > Admin-Werkzeuge > Benutzerdefinierte Schriftarten hoch und wählen Sie die Schriftart dann unter Einstellungen > Anzeige > App-Schriftart oder Einstellungen > Markdown > Markdown-Editor-Schriftart.

Hinweise:

• Akzeptiert werden WOFF2, WOFF, TTF und OTF, bis zu 10 MB pro Datei.
• Eine Familie besteht aus mehreren Dateien (normal, fett, kursiv...) oder aus einer einzigen variablen Schriftdatei. Wählen Sie alle Dateien einer Familie in einem Upload aus, sie werden unter dem Familiennamen zusammengefasst.
• Die Schriftarten werden von Ihrer eigenen Instanz ausgeliefert, es wird nichts von Google oder einem anderen Drittanbieter geladen. Laden Sie die Familie zuerst herunter, von Google Fonts (Get font > Download all) oder google-webfonts-helper.
• Eine Familie ohne fette Datei behält für fetten Text und Überschriften die Standardschriftart, laden Sie also auch die fette Datei hoch.
• Die Dateien werden in data/fonts/ (Ihrem Docker-Volume) gespeichert und überstehen daher Image-Updates. Von Hand dorthin kopierte Dateien werden beim Öffnen des Dialogs Benutzerdefinierte Schriftarten erkannt.
• Jeder Benutzer wählt seine eigene Schriftart. Wird eine Familie gelöscht, erhalten die Benutzer, die sie gewählt hatten, wieder die Standardschriftart.
• Nur Administratoren können Schriftarten hochladen oder löschen.

Wenn Sie Schriften, Abstände oder andere visuelle Details über die integrierten Optionen hinaus anpassen möchten, können Sie zusätzliche Stylesheets hochladen, die auf jede HTML-Seite für alle Benutzer angewendet werden.

Konfigurieren Sie sie unter Einstellungen > Admin-Werkzeuge > Benutzerdefinierte CSS-Datei.

Hinweise:

• Klicken Sie auf CSS-Datei hochladen, um eine .css-Datei von Ihrem Computer auszuwählen.
• Jede hochgeladene Datei bleibt erhalten, sodass Sie mehrere Designs speichern und zwischen ihnen wechseln können, ohne sie erneut hochzuladen.
• Der Dialog listet die gespeicherten Dateien auf: Wählen Sie diejenige, die für alle Benutzer gelten soll, oder Kein eigenes CSS, um zum integrierten Erscheinungsbild zurückzukehren, und klicken Sie dann auf Speichern.
• Das Hochladen einer Datei mit dem Namen einer bereits gespeicherten ersetzt dieses Design.
• Die Dateien werden in data/css/ (Ihrem Docker-Volume) gespeichert und überstehen daher Image-Aktualisierungen.
• Klicken Sie auf das Papierkorbsymbol neben einem Design, um diese Datei aus Ihrem Volume zu löschen.
• Poznote hängt automatisch einen Cache-Busting-Parameter v= an.
• Das Stylesheet wird gegen Ende von <head> eingefügt und kann daher die Standardstile der Anwendung überschreiben.
• Nur Administratoren können eine benutzerdefinierte CSS-Datei hochladen, anwenden oder löschen.

Die Theme-Liste

Einstellungen > Admin-Werkzeuge > Theme-Liste legt fest, durch welche Designs die Design-Schaltfläche unten in der Symbolleiste schaltet: ein Design pro Klick, in der angezeigten Reihenfolge.

• Haken Sie die integrierten Designs an, die Sie behalten möchten, und lassen Sie die weg, die niemand verwendet.
• Haken Sie eine gespeicherte CSS-Datei an, um sie als eigenes Design anzubieten. Sie erhält ein Palettensymbol und den Namen der Datei.
• Legen Sie mit den Pfeilen die Reihenfolge fest, in der die Schaltfläche durchschaltet.
• Ein benutzerdefiniertes Design wird über eine helle oder dunkle Basis gelegt, was die Datei selbst nicht angeben kann: Wählen Sie die Basis neben der Datei. Darauf wird data-theme gesetzt, ein für den Dunkelmodus geschriebenes Stylesheet braucht hier also Dunkel.
• Die Liste ist eine globale Einstellung, alle schalten also durch dieselben Designs; welches angewendet wird, bleibt die Wahl jedes einzelnen Benutzers.
• Wer ein Design verwendet, das Sie aus der Liste entfernen, erhält sofort das erste Design der Liste.
• Die Auswahl eines benutzerdefinierten Designs lädt diese Datei nur für diesen Benutzer, anstelle des instanzweit angewendeten Stylesheets.
• Das Löschen einer CSS-Datei entfernt sie auch aus der Liste.
• Steht nur ein einziges Design in der Liste, gibt es nichts zum Durchschalten: Die Schaltfläche öffnet dann für Administratoren diese Liste und bewirkt für alle anderen nichts.

Bevor Sie CSS schreiben, prüfen Sie, ob ein integriertes Design bereits das tut, was Sie möchten: Die Design-Schaltfläche unten in der Symbolleiste schaltet durch Hell, Dunkel, Schwarz, Lavendel, Sepia und Terminal.

Beispiele

Farben, Abstände, Radien und Schriftstärken sind Design-Tokens, daher bestehen die meisten Änderungen aus einer kurzen Liste überschriebener Variablen statt aus einem Kampf mit Selektoren. Die vollständige Liste finden Sie in src/public/css/tokens.css.

Akzentfarbe ändern

:root {
    --pz-accent: #d6336c;
    --pz-accent-hover: #a61e4d;
    --pz-accent-rgb: 214, 51, 108;   /* same colour, channels only, used for tints */
}
html[data-theme='dark'] {
    --pz-accent-text: #f783ac;       /* lighter, because it sits on a dark ground */
}

Zwei Tokens statt einem, weil eine Füllung und eine Beschriftung nicht dieselbe Farbe haben können: --pz-accent füllt Schaltflächen, --pz-accent-text ist die Akzentfarbe für Text, Symbole und Umrisse. In einem hellen Design folgt es --pz-accent von selbst; ein dunkler Grund braucht einen helleren Wert. Jedes Token behält in jedem Design denselben --pz-*-Namen, nur sein Wert ändert sich. Die --dm-*-Namen älterer Stylesheets funktionieren weiterhin.

Symbole der Notiz-Werkzeugleiste umfärben

.note-edit-toolbar .toolbar-btn i,
.note-edit-toolbar .toolbar-btn [class*="lucide-"],
.note-edit-toolbar .toolbar-btn:hover i,
.note-edit-toolbar .toolbar-btn:hover [class*="lucide-"] {
    color: #e5322d !important;
}

Symbole sind CSS-Masken, die mit background-color: currentColor gezeichnet werden, daher genügt color. !important ist hier nötig, weil einige dieser Symbole bereits eine eigene Farbe tragen (der Stern, wenn eine Notiz ein Favorit ist, das Teilen-Symbol, wenn sie veröffentlicht ist, die Büroklammer, wenn sie Anhänge hat).

Für ein einzelnes Symbol braucht es kein CSS: Klicken Sie es in der Notiz-Symbolleiste oder in der Icon-Seitenleiste mit der rechten Maustaste an und wählen Sie eine Farbe. Diese Farben werden pro Benutzer gespeichert und lassen die oben genannten Statusfarben unverändert.

Die gesamte Oberfläche wärmer gestalten

:root {
    --pz-bg: #f6ecd8;          /* page and note background */
    --pz-surface: #efe0c4;     /* panels, cards, menus */
    --pz-text: #3b2c1a;
    --pz-border: #d4bd94;
}

Ein vollständiges Design schreiben

Überschreiben Sie die Tokens auf :root für hell und auf :root[data-theme='dark'] für dunkel, und sonst nichts. src/public/css/README.md dokumentiert jedes Token und zeigt ein vollständiges Beispiel; die integrierten Designs Lavendel, Sepia und Terminal in src/public/css/tokens.css sind genau dasselbe, auf dieselbe Weise geschrieben.

Einige Funktionen lassen den Poznote-Server selbst eine Verbindung zu einer Adresse aufbauen, die ein Benutzer eingegeben hat: Webhooks, Git Sync und seine eigenen KI-, Transkriptions- oder MCP-Server. Die Anfrage geht vom Server aus, nicht vom Browser des Benutzers. Ohne Grenze könnte also jedes Konto über Poznote den Server selbst, die anderen Docker-Container, Ihr lokales Netzwerk oder einen Cloud-Metadatendienst erreichen, also Orte, die es selbst nicht erreichen kann.

Die Regel hängt deshalb davon ab, wer die Adresse eingegeben hat:

• Administratoren sind nicht eingeschränkt: Sie kontrollieren den Server ohnehin.
• Andere Benutzer können nur öffentliche Internet-Hosts verwenden. Eine lokale oder private Adresse wird abgelehnt: localhost und 127.0.0.1, 10.x.x.x, 172.16.x.x bis 172.31.x.x, 192.168.x.x, 169.254.x.x, lokale IPv6-Adressen (fc00::/7, fe80::/10) sowie jeder Name, der auf eine davon zeigt, etwa der Name eines anderen Docker-Dienstes.

Was ein Administrator für die ganze Instanz einstellt (der KI-Assistent, die Transkription, die Admin-Webhooks, S3, OIDC, SMTP), ist nicht betroffen.

Auf einer Familien- oder Team-Instanz brauchen Benutzer vielleicht einen Server in Ihrem Netzwerk, etwa einen Ollama-Server für ihre persönliche KI oder n8n für ihre Webhooks. Tragen Sie diese Hosts unter Einstellungen > Admin-Werkzeuge > Integrationen > Zugriff auf das lokale Netzwerk ein, ein Eintrag pro Zeile:

Ein Eintrag erlaubt alle Ports dieses Hosts. Ungültige Einträge werden beim Speichern abgelehnt, mit der Liste der zu korrigierenden. Die Karte zeigt Nur öffentlich, solange die Liste leer ist, sonst die Zahl der Einträge.

Gut zu wissen:

• Ein Hostname in der Liste muss im Poznote-Container auflösbar sein, nicht nur auf Ihrem Computer. Einen Namen, den nur Ihr Computer oder Ihr Router kennt, kann Poznote nicht auflösen, und er wird wie jeder unbekannte Name abgelehnt: Geben Sie stattdessen seine Adresse oder sein Netzwerk ein.
• Die Adresse wird bei jeder Verbindung erneut geprüft, nicht nur beim Speichern: Das Entfernen eines Eintrags wirkt sofort, und ein Name, der später auf eine lokale Adresse zeigt, wird abgelehnt.
• Für Benutzer ohne Administratorrechte folgt Poznote keinen Weiterleitungen, außer bei Git Sync, das jeden Schritt der Weiterleitung erneut prüft.

Poznote verwendet eine Master-Datenbank (data/master.db) für gemeinsame Koordinationsdaten sowie separate Datenbanken und Dateien pro Benutzer für die eigentlichen Notizinhalte.

data/
├── master.db                    # Profiles, global settings, shared links, account access, edit locks
├── css/                         # Custom CSS files uploaded by an administrator
├── fonts/                       # Custom fonts uploaded by an administrator
├── backups/                     # Scheduled local backups, one folder per user ID
└── users/
    ├── 1/                       # User ID 1 (default admin)
    │   ├── database/poznote.db  # User's notes database
    │   ├── entries/             # User's note files (HTML/MD)
    │   ├── attachments/         # User's attachments
    │   ├── snapshots/           # Earlier versions of the user's notes (revisions)
    │   ├── backgrounds/         # Workspace background images
    │   └── backups/             # Backup archives prepared for download
    ├── 2/                       # User ID 2
    └── ...

Schritt 1: Funktion aktivieren (Administrator, unter Einstellungen > Admin-Werkzeuge)

Aktivieren Sie Git-Synchronisierung im Bereich Admin-Werkzeuge der Einstellungsseite. Damit wird die Git-Synchronisierung global eingeschaltet, und die Karte bzw. Konfiguration Git-Synchronisierung auf Benutzerebene steht unter Einstellungen zur Verfügung.

Schritt 2: Jeder Benutzer konfiguriert sein eigenes Repository (Einstellungen > Git-Synchronisierung)

🔒 Zugriffstokens werden im Ruhezustand mit AES-256-GCM verschlüsselt. Ein Schlüssel wird automatisch erzeugt und in data/.app_secret gespeichert.

Automatische Synchronisierung

Wenn der Benutzer sie aktiviert, führt Poznote automatisch Folgendes aus:

• Pull bei der Anmeldung
• Push bei jedem Erstellen, Ändern oder Löschen einer Notiz

Manuelles Senden und Abrufen ist außerdem über die Schaltflächen Senden und Abrufen der linken Symbolleiste möglich.

Synchronisierte Arbeitsbereiche

Standardmäßig wird jeder Arbeitsbereich synchronisiert. Unter Einstellungen > Git-Synchronisierung kann jeder Benutzer die Synchronisierung stattdessen auf ausgewählte Arbeitsbereiche beschränken:

• Nur Notizen und Anhänge aus den ausgewählten Arbeitsbereichen werden gesendet und abgerufen.
• Ein Pull verändert niemals Notizen in den anderen Arbeitsbereichen.
• Ein Push entfernt Dateien im Repository, die außerhalb der ausgewählten Arbeitsbereiche liegen, sodass das Repository immer genau den synchronisierten Bestand widerspiegelt.
• Die Schaltflächen Senden und Abrufen in der Seitenleiste, der automatische Push und die Pull-Aufforderung erscheinen nur, während Sie einen synchronisierten Arbeitsbereich ansehen.

Konfigurieren Sie ihn unter Einstellungen > S3-Anhänge (nur Administratoren).

• Konfiguration: Endpunkt-URL, Region, Bucket, Access Key, Secret Key und Path-Style-Adressierung, mit integriertem Verbindungstest.
• Migration: Verschieben Sie vorhandene Anhangsdateien zwischen lokaler Festplatte und Bucket, in beide Richtungen und für alle Benutzer. Die Migration läuft in Stapeln und kann gefahrlos unterbrochen und fortgesetzt werden.
• Datenschutz: Anhänge werden im Bucket unter attachments/{user id}/ gespeichert und immer über Poznote ausgeliefert, sodass der Bucket privat bleiben kann.
• Kontingente: Pro Benutzer lässt sich ein S3-Speicherkontingent festlegen, und die S3-Nutzung erscheint in der Speicherstatistik für Administratoren.
• Sicherungen: ZIP-Exporte enthalten S3-Anhänge standardmäßig (sie werden dabei direkt aus dem Bucket geholt), unabhängig davon, ob sie im Sicherungsfenster, über die REST-API oder durch die automatischen S3-Sicherungen erstellt werden. Eine Option im Sicherungsfenster erlaubt es, sie für ein schlankeres Archiv wegzulassen. Kann der Bucket während der Erstellung eines Archivs nicht gelesen werden, schlägt der Export mit einem Fehler fehl, statt ein Archiv mit fehlenden Dateien zu erzeugen.

Das Wiederherstellen einer Sicherung, in der einige der referenzierten Anhangsdateien fehlen, wird bei aktiviertem S3-Speicher abgelehnt, weil eine vollständige Wiederherstellung den Inhalt des Buckets ersetzt und die fehlenden Dateien verloren gingen. Eine solche Sicherung lässt sich auf zwei Wegen wiederherstellen:

• Am einfachsten: Schalten Sie „Anhänge in S3 speichern“ aus (die Zugangsdaten bleiben erhalten), stellen Sie die Sicherung wieder her und schalten Sie den Schalter dann wieder ein. Eine Wiederherstellung im lokalen Modus verändert den Bucket nie, und die dort noch gespeicherten Anhänge werden weiterhin ausgeliefert. Dies ist auch der richtige Weg auf einem neuen Server mit intaktem Bucket, da der Anhang-Export der anderen Option eine Instanz voraussetzt, die die Notizen noch kennt.
• Ein vollständiges Archiv neu erstellen:
  1. Laden Sie im Sicherungsfenster den Anhang-Export herunter: Er enthält alle Anhänge Ihres Kontos in einem Ordner files/.
  2. Entpacken Sie die Sicherung, kopieren Sie die Dateien aus files/ in den Ordner attachments/ der Sicherung und packen Sie sie wieder als ZIP. Achtung beim erneuten Packen: Wählen Sie den Inhalt der Sicherung (database/, entries/, attachments/, ...) aus und komprimieren Sie diese Auswahl, nicht den Ordner, der sie enthält. Die Ordner müssen im Stammverzeichnis der ZIP-Datei liegen, sonst meldet die Wiederherstellung, dass database/poznote_backup.sql fehlt.
  3. Stellen Sie die neu erstellte ZIP-Datei ganz normal wieder her.

Die Git-Synchronisierung ignoriert Anhänge, solange der S3-Speicher aktiviert ist.

Eine einzige ZIP-Datei mit der Datenbank, allen Notizen und Anhängen aller Arbeitsbereiche:

• Enthält eine index.html im Stammverzeichnis zum Offline-Durchblättern
• Notizen sind nach Arbeitsbereich und Ordner geordnet
• Anhänge sind über anklickbare Links erreichbar

Das Archiv wird im Hintergrund von einem Worker-Prozess erstellt, nicht während der Anfrage, die es anstößt, sodass auch ein großes Konto nicht an ein Timeout des Browsers oder eines Reverse Proxys stößt. Die Seite verfolgt den Fortschritt des Auftrags, und der Download startet von selbst, sobald die Datei bereit ist. Sie können die Seite verlassen und später zurückkehren, die Vorbereitung läuft weiter. Ein vorbereitetes Archiv bleibt 24 Stunden lang verfügbar, und eine Schaltfläche ermöglicht es, es sofort zu löschen.

Sicherungen pro Benutzer und vollständige Sicherungen

Alle oben genannten Methoden erzeugen Sicherungen pro Benutzer: Ein Archiv enthält nur die Daten eines einzelnen Kontos (seine Datenbank, Notizen und Anhänge). Jeder Benutzer kann sein eigenes Konto sichern und wiederherstellen, Administratoren können jedes Konto auswählen. Das Archiv eines Administrators enthält außerdem das Logo der Instanz, falls eines hochgeladen wurde, und die Wiederherstellung in einem Administratorkonto bringt dieses Logo zurück.

Eine vollständige Systemsicherung, die die Master-Konfiguration (Konten, globale Einstellungen, geteilte Links) und alle Benutzer auf einmal umfasst, erfolgt durch Kopieren des gesamten Verzeichnisses /data:

# Vollständige Systemsicherung über die Kommandozeile
tar -czvf poznote-full-backup.tar.gz data/

Administratoren können vollständige Sicherungsarchive (eine ZIP-Datei pro Benutzer, identisch mit der über „Sicherung als Poznote-ZIP-Datei“ heruntergeladenen) manuell oder automatisch nach Zeitplan in einem Ordner des Servers speichern lassen, wobei nur die neuesten aufbewahrt werden. Außer Poznote wird nichts benötigt: kein Bucket, kein Cronjob, kein Skript.

Konfigurieren Sie sie unter Einstellungen > Sicherungen auf dem Server (nur Administratoren).

• Sicherungsordner: Ein absoluter Pfad auf dem Server (mit Docker: im Container). Bleibt das Feld leer, landen die Archive in data/backups, das bereits zum Daten-Volume gehört. Der Ordner wird bei Bedarf angelegt und muss für den Benutzer des Webservers beschreibbar sein.
• Benutzerauswahl: Kontrollkästchen legen fest, welche Benutzer gesichert werden. Standardmäßig sind alle ausgewählt, und solange alle ausgewählt sind, werden neue Konten automatisch einbezogen.
• Manuelle Sicherungen: Die Schaltfläche „Jetzt sichern“ speichert für jeden ausgewählten Benutzer ein neues Archiv, einen Benutzer nach dem anderen, mit Fortschritt pro Benutzer. Sie funktioniert auch, wenn die automatischen Sicherungen aus sind.
• Automatische Sicherungen: Sind sie aktiviert, sichert ein Hintergrund-Worker die ausgewählten Benutzer in der gewählten Häufigkeit (täglich, wöchentlich oder monatlich). Der erste Lauf erfolgt wenige Minuten nach dem Aktivieren, die nächsten nach dem gewählten Intervall. Die Seite zeigt das Ergebnis des letzten Laufs und das Datum des nächsten.
• Aufbewahrung: Pro Benutzer werden nur die N neuesten Archive behalten, ältere werden nach jeder Sicherung aus dem Ordner gelöscht (0 behält alles).
• Durchsuchen: Die Seite listet die Archive im Ordner auf, mit Aktionen zum Herunterladen und Löschen.
• Wiederherstellung: Archive werden im Sicherungsordner unter {Benutzer-ID}/ gespeichert und können mit der Standardseite Wiederherstellen / Importieren wiederhergestellt werden.
• Kontolöschung: Beim Löschen eines Kontos werden auch dessen Archive aus dem Sicherungsordner gelöscht.

Um die Sicherungen auf einer anderen Festplatte oder einer Netzwerkfreigabe abzulegen, binden Sie diese in den Container ein und geben Sie den Pfad im Container (/backups in diesem Beispiel) als Sicherungsordner an:

services:
  webserver:
    volumes:
      - "./data:/var/www/html/data"
      - "/mnt/nas/poznote-backups:/backups"

Ein Ordner innerhalb der Anwendung selbst wird abgelehnt, außer data/backups. Wenn Anhänge in S3 gespeichert sind (S3-Speicher für Anhänge), sind sie in den Archiven enthalten und werden direkt aus dem Bucket abgerufen.

Administratoren können vollständige Sicherungsarchive (eine ZIP-Datei pro Benutzer, identisch mit der über „Sicherung als Poznote-ZIP-Datei“ heruntergeladenen) manuell oder automatisch nach Zeitplan an einen S3-kompatiblen Bucket senden. Die Konfiguration ist unabhängig von der des S3-Speichers für Anhänge, sodass Sicherungen einen anderen Bucket oder Anbieter nutzen können.

Konfigurieren Sie sie unter Einstellungen > S3-Sicherungen (nur Administratoren).

• Hauptschalter: Ein Schalter oben auf der Seite aktiviert oder deaktiviert die gesamte Funktion. Ist er deaktiviert, stoppen die automatischen Sicherungen, und die Bereiche für S3-Sicherung und -Wiederherstellung verschwinden für alle Benutzer (die Self-Service-Aktionen werden auch serverseitig abgelehnt).
• Konfiguration: Endpunkt-URL, Region, Bucket, Access Key, Secret Key und Path-Style-Adressierung, mit integriertem Verbindungstest.
• Benutzerauswahl: Über Kontrollkästchen wählen Sie, welche Benutzer gesichert werden. Standardmäßig sind alle ausgewählt, und solange alle ausgewählt sind, werden neue Konten automatisch einbezogen.
• Manuelle Sicherungen: Die Schaltfläche „Jetzt sichern“ lädt für jeden ausgewählten Benutzer ein neues Archiv hoch, einen Benutzer nach dem anderen, mit Fortschrittsanzeige pro Benutzer. Sie funktioniert, sobald die Verbindung konfiguriert ist, auch wenn die automatischen Sicherungen ausgeschaltet sind.
• Automatische Sicherungen: Wenn aktiviert, sichert ein Hintergrundprozess die ausgewählten Benutzer im gewählten Rhythmus (täglich, wöchentlich oder monatlich). Der erste Durchlauf erfolgt wenige Minuten nach dem Aktivieren, die folgenden nach dem gewählten Intervall.
• Aufbewahrung: Pro Benutzer werden nur die N neuesten Archive aufbewahrt, ältere werden nach jeder Sicherung aus dem Bucket gelöscht (0 bewahrt alles auf).
• Durchsuchen: Die Seite listet die aktuell im Bucket vorhandenen Archive mit Aktionen zum Herunterladen und Löschen auf.
• Wiederherstellung: Archive werden im Bucket unter backups/{user id}/ gespeichert und können über die normale Seite Wiederherstellen / Importieren wiederhergestellt werden.
• Self-Service: Sobald der Bucket konfiguriert ist, erhält jeder Benutzer auf seiner Seite Sicherung / Export einen Bereich „Sicherung nach S3“, um ein neues Archiv seines eigenen Kontos hochzuladen und seine vorhandenen Archive herunterzuladen oder zu löschen. Ein Bereich „Aus S3 wiederherstellen“ auf der Seite Wiederherstellen / Importieren stellt sein Konto direkt aus einem dieser Archive wieder her.
• Mandantentrennung: Zwei Optionen („S3-Sicherungen auf der Sicherungsseite“ und „S3-Wiederherstellung auf der Wiederherstellungsseite“) deaktivieren diese Self-Service-Bereiche für Benutzer ohne Administratorrechte. Sie werden serverseitig durchgesetzt, sodass die gesperrten Aktionen auch bei direktem Aufruf abgelehnt werden.

Werden Anhänge in S3 gespeichert (S3-Speicher für Anhänge), sind sie standardmäßig in den Archiven enthalten und werden dabei direkt aus dem Bucket geholt. Mit einer Option können Sie sie für schlankere Archive und schnellere Durchläufe aus den Sicherungen herauslassen.

Für automatisierte, zeitgesteuerte Sicherungen über die API können Sie das mitgelieferte Skript backup-poznote.sh verwenden.

WICHTIG: Nur Administratoren können über die API Sicherungen erstellen. Verwenden Sie das aktuelle Passwort des Administratorprofils, mit dem Sie sich authentifizieren. Bei einer Neuinstallation ist das das Standard-Administratorpasswort (admin), bis es in Poznote geändert wird. Sobald ein eigenes Passwort festgelegt ist, wird dieses für API-Aufrufe benötigt.

Speicherort des Skripts: backup-poznote.sh im Ordner tools des Poznote-Repositorys

Verwendung durch Administratoren:

Administratoren können jedes Benutzerprofil sichern, ohne Benutzer-IDs kennen zu müssen, der Benutzername genügt:

# Eigenes Profil sichern
bash backup-poznote.sh 'https://poznote.example.com' 'admin' 'admin_password' 'admin' '/backups' '30'

# Profil eines anderen Benutzers sichern (Nina)
bash backup-poznote.sh 'https://poznote.example.com' 'admin' 'admin_password' 'Nina' '/backups' '30'

Verwendung:

bash backup-poznote.sh '<poznote_url>' '<admin_username>' '<admin_password>' '<target_username>' '<backup_directory>' '<retention_count>'

Beispiel mit crontab (Administrator sichert Nina):

# In die crontab eintragen, um zweimal täglich automatisch zu sichern
0 0,12 * * * bash /root/backup-poznote.sh 'https://poznote.example.com' 'admin' 'admin_password' 'Nina' '/root/backups' '30'

Die Parameter im Einzelnen:

• 'https://poznote.example.com': URL Ihrer Poznote-Instanz
• 'admin': Administrator-Benutzername für die Authentifizierung (muss ein Administrator sein)
• 'admin_password': Aktuelles Administratorpasswort des API-Profils (admin, bis es geändert wird, danach das eigene Passwort)
• 'Nina': Benutzername des zu sichernden Benutzers
• '/root/backups': Übergeordnetes Verzeichnis, in dem die Sicherungen gespeichert werden (legt den Ordner backups-poznote-<username> an)
• '30': Anzahl der aufzubewahrenden Sicherungen (ältere werden automatisch gelöscht)

So läuft die Sicherung ab:

1. Das Skript authentifiziert sich mit den Administrator-Zugangsdaten
2. Es ermittelt automatisch die Benutzer-ID anhand des Benutzernamens
3. Es erstellt eine Sicherung über die API
4. Es ruft die Poznote-REST-API v1 auf (POST /api/v1/backups mit dem Header X-User-ID)
5. Es lädt die Sicherungs-ZIP lokal nach backups-poznote-<username>/ herunter
6. Es verwaltet die Aufbewahrung automatisch (bewahrt nur die angegebene Anzahl neuester Sicherungen auf)

Hinweis: Die Sicherungen jedes Benutzers werden in separaten Ordnern abgelegt (backups-poznote-Nina, backups-poznote-Tim usw.)

Exportieren Sie einzelne Notizen über die Schaltfläche Exportieren in der Werkzeugleiste der Notiz:

• Rich-Text-Notizen: Export als HTML oder als einzelne HTML-Datei mit eingebetteten Bildern
• Markdown-Notizen: Export als Markdown, als HTML oder als einzelne HTML-Datei mit eingebetteten Bildern
• Aufgabenlisten: dieselben Optionen, dazu ein JSON-Rohexport der Liste

Laden Sie die vollständige Sicherungs-ZIP hoch, um alles wiederherzustellen:

• Ersetzt die Datenbank und stellt alle Notizen und Anhänge wieder her
• Wirkt auf alle Arbeitsbereiche gleichzeitig

Es gibt praktisch keine Größenbeschränkung. Das Archiv wird in Teilstücken hochgeladen (ein fehlgeschlagenes Teilstück wird erneut gesendet, statt den gesamten Upload zu verlieren), auf dem Server wieder zusammengesetzt und anschließend von einem Hintergrundprozess entpackt und wiederhergestellt, sodass weder der Browser noch ein vorgeschalteter Reverse Proxy die Wiederherstellung durch ein Timeout abbrechen kann. Ein Fortschrittsbalken deckt den gesamten Ablauf ab: Upload, Entpacken, Datenbank, Notizen, dann Anhänge. Nach Abschluss der Wiederherstellung fragt Poznote, welchen Arbeitsbereich Sie öffnen möchten.

Die Wiederherstellung aus einem S3-Bucket (siehe S3-Sicherungen) läuft als derselbe Hintergrundauftrag, sodass auch das Abrufen eines großen Archivs aus dem Bucket und seine Wiederherstellung nicht davon abhängen, dass eine Anfrage bestehen bleibt.

Ist ein Upload überhaupt nicht möglich, bietet die Seite Wiederherstellen / Importieren zusätzlich eine Alternative, „Wiederherstellung per Direktkopie“: Kopieren Sie das Archiv per SSH in den Poznote-Container, genau nach /tmp/backup_restore.zip, laden Sie die Seite neu und stellen Sie von dort aus wieder her.

Importieren Sie eine oder mehrere HTML-, Markdown- oder Textnotizen direkt:

• Unterstützt die Dateitypen .html, .md, .markdown, .txt und .json
• Bis zu 50 Dateien können gleichzeitig ausgewählt werden, einstellbar unter Einstellungen > Admin-Werkzeuge > Importlimits

Importieren Sie ein ZIP-Archiv mit mehreren Notizen:

• Unterstützt die Dateitypen .html, .md, .markdown oder .txt
• ZIP-Archive können bis zu 300 Dateien enthalten, einstellbar unter Einstellungen > Admin-Werkzeuge > Importlimits
• Beim Import eines ZIP-Archivs erkennt Poznote die Ordnerstruktur automatisch und legt sie neu an

Für das Archiv gibt es praktisch keine Größenbeschränkung. Wie bei einer vollständigen Wiederherstellung wird es in Teilstücken hochgeladen (ein fehlgeschlagenes Teilstück wird erneut gesendet, statt den gesamten Upload zu verlieren), auf dem Server wieder zusammengesetzt und anschließend von einem Hintergrundprozess verarbeitet, sodass weder der Browser noch ein vorgeschalteter Reverse Proxy den Import durch ein Timeout abbrechen kann. Ein Fortschrittsbalken deckt den gesamten Ablauf ab: Upload, Bilder und Anhänge, dann Notizen.

Ein Obsidian-Vault ist ein Ordner mit Markdown-Dateien und lässt sich daher unverändert in einem einzigen ZIP-Archiv importieren.

Schritte

1. Komprimieren Sie den Ordner Ihres Vaults zu einer ZIP-Datei. Vorher muss nichts bereinigt werden: Versteckte Ordner wie .obsidian oder .trash werden ignoriert.
2. Öffnen Sie in Poznote Einstellungen > Wiederherstellen / Importieren und gehen Sie zum Abschnitt, der Dateien und ZIP-Archive importiert. Wählen Sie den Ziel-Workspace (ein neuer, leerer Workspace macht das Ergebnis leicht überprüfbar), wählen Sie die ZIP-Datei aus und starten Sie den Import. Die ZIP-Datei auf die Notizliste der Hauptseite zu ziehen, bewirkt dasselbe.
3. Lesen Sie die Zusammenfassung am Ende: Sie nennt die Anzahl der importierten Notizen, Ordner, Bilder und PDF-Dateien sowie die Dateien, die nicht importiert werden konnten.

Eine ZIP-Datei kann bis zu 300 Notizen enthalten (Bilder und PDF-Dateien zählen nicht mit). Ein Administrator kann dieses Limit unter Einstellungen > Admin-Werkzeuge > Importlimits anheben. Die Größe des Archivs ist nicht begrenzt, siehe ZIP-Datei importieren.

Was übernommen wird

• Notizen: Jede .md-Datei wird zu einer Markdown-Notiz, benannt nach der Datei oder nach dem Schlüssel title ihres Front Matters.
• Ordner: Die Ordnerstruktur des Vaults wird samt Unterordnern neu angelegt. Liegt der gesamte Vault in einem einzigen Ordner auf oberster Ebene der ZIP-Datei, wird dieser Ordner übersprungen.
• Tags: der Schlüssel tags des Front Matters und eine Zeile mit #tags ganz oben in einer Notiz. Leerzeichen in einem Tag werden zu Unterstrichen.
• Front Matter: title, folder, tags, favorite, created und updated werden gelesen, siehe Unterstützung von Markdown-Front-Matter.
• Links zwischen Notizen: [[Titel der Notiz]] funktioniert unverändert. Poznote löst den Link über den Titel auf, zeigt ihn als internen Link an und berücksichtigt ihn in den Backlinks und im Graphen.
• Bilder: ![[bild.png]], ![[bild.png|Beschriftung]] und ![Beschriftung](bild.png) werden zu Anhängen der Notiz und an Ort und Stelle angezeigt, egal wo das Bild im Vault liegt (neben den Notizen, in einem Unterordner oder in einem Ordner attachments).
• PDF-Dateien: Ein aus einer Notiz verlinktes PDF (![[datei.pdf]], [[datei.pdf]] oder ein Markdown-Link) wird an diese Notiz angehängt, und der Link zeigt auf den Anhang. Jedes andere PDF, neben den Notizen oder in einem Ordner attachments, wird zu einer nach der Datei benannten Notiz mit dem PDF als Anhang, im Ordner, der seinem Platz im Vault entspricht.

Was nicht übernommen wird

• Links mit Alias oder auf eine Überschrift ([[Notiz|Alias]], [[Notiz#Überschrift]]) bleiben im Text, führen aber zu keiner Notiz.
• Eingebettete Notizen (![[Andere Notiz]]) und Plugin-Inhalte: Dataview-Abfragen, .canvas-Dateien, Zeichnungen aus dem Excalidraw-Plugin von Obsidian.
• Tags mitten in einer Notiz bleiben einfacher Text.
• Dateien anderer Typen neben den Notizen (Audio, Video, Office-Dokumente) werden ignoriert. Hängen Sie sie anschließend an die betreffende Notiz an.

Bilder und PDF-Dateien werden über den Dateinamen zugeordnet, nicht über den Pfad. Tragen zwei Dateien des Vaults denselben Namen, benennen Sie eine davon vor dem Import um.

Markdown-Dateien können YAML-Front-Matter enthalten, um Metadaten der Notiz festzulegen. Folgende Schlüssel werden unterstützt:

• title: Überschreibt den Titel der Notiz (Standard: Dateiname ohne Endung)
• folder: Überschreibt den Zielordner. Ein einfacher Name muss einem Ordner entsprechen, der im Arbeitsbereich bereits existiert; ein Pfad wie Projects/2026 legt die benötigten Ordner an.
• tags: Array von Tags, die der Notiz zugewiesen werden. Unterstützt sowohl die Inline-Syntax [tag1, tag2] als auch die mehrzeilige Syntax
• favorite: Markiert die Notiz als Favorit (true oder false)
• created: Legt ein eigenes Erstellungsdatum fest (Format: YYYY-MM-DD HH:MM:SS)
• updated: Legt ein eigenes Änderungsdatum fest (Format: YYYY-MM-DD HH:MM:SS)

Beispiel mit Inline-Array-Syntax:

---
title: My Important Note
folder: Projects
tags: [important, work]
favorite: true
created: 2024-01-15 10:30:00
updated: 2024-01-20 15:45:00
---

Beispiel mit mehrzeiliger Syntax:

---
title: My Important Note
folder: Projects
tags:
  - important
  - work
favorite: true
created: 2024-01-15 10:30:00
updated: 2024-01-20 15:45:00
---

Die in den letzten 5 Tagen geänderten Notizen werden in jedem Browser aufbewahrt, in dem Sie Poznote verwenden, und diese Kopie wird nach jedem Speichern aktualisiert. Im Unterricht, im Zug oder überall ohne WLAN öffnen Sie die gewohnte Poznote-Adresse: Der Browser zeigt die Offline-Version von Poznote mit derselben Seitenleiste, denselben Editoren, derselben Werkzeugleiste, derselben Suche und denselben Tabs (ein Doppelklick oder ein Mittelklick öffnet eine Notiz in einem neuen Tab, und die online geöffneten Tabs werden übernommen), listet aber nur die offline aufbewahrten Notizen auf.

• Anmeldung: Geben Sie das Passwort Ihrer letzten Anmeldung in diesem Browser ein, es wird ohne den Server geprüft. Haben Sie in diesem Browser nie Ihr Passwort eingegeben (SSO, automatische Anmeldung), öffnet sich das zuletzt verwendete Konto mit der Schaltfläche Weiter als.
• Lesen und Bearbeiten: Rich-Text-Notizen, Markdown-Notizen und Aufgabenlisten öffnen sich in ihrem gewohnten Editor, und neue Notizen können erstellt werden. Das /-Menü und das Rechtsklick-Menü funktionieren ebenfalls, ohne die Befehle, die den Server brauchen (hochzuladende Bilder und Dateien, Vorlagen, Zeichnungen, Links zu anderen Notizen). Andere Notiztypen, etwa Zeichnungen, bleiben nur online verfügbar. Änderungen bleiben im Browser, bis sie gesendet sind.
• Offline behalten: Favoriten werden immer aufbewahrt, und Offline behalten im Menü einer Notiz oder eines Ordners (Unterordner eingeschlossen) bewahrt sie unabhängig vom Datum auf, mit allen Anhängen (PDF, Audio, Dateien) bis 25 MB pro Datei. Dasselbe Menü einer Notiz zeigt an, ob sie in diesem Browser offline verfügbar ist, und die Seiten Notizen und Ordner markieren die in diesem Browser offline verfügbaren Notizen und Ordner. Auf der Seite Notizen lassen sich über die Sammelaktionen auch mehrere Notizen auf einmal offline behalten (oder nicht mehr), und die Seite Ordner bietet Offline behalten im Menü jedes Ordners.
• Offline-Seite: Die Schaltfläche Offline der Symbolleiste listet die offline behaltenen Notizen und Ordner auf, wie die Seite Freigaben: Ordner als Baum mit ihren Notizen, der Grund, warum jede Notiz behalten wird (offline behalten, in einem offline behaltenen Ordner, Favorit, kürzlich geändert), ein Filter und eine Schaltfläche, um eine Notiz offline zu behalten oder damit aufzuhören. Ein Warnsymbol markiert eine Notiz, die dieser Browser noch nicht hat.
• Wieder online: Die Änderungen werden automatisch gesendet. Wurde eine Notiz inzwischen auch auf dem Server geändert, werden beide Fassungen nach Möglichkeit zusammengeführt, andernfalls wird Ihre Offline-Fassung als eigene Notiz mit dem Namen „... (Offline-Kopie)“ behalten. Eine inzwischen auf dem Server gelöschte Notiz wird neu angelegt.
• Einstellungen: Einstellungen > Synchronisierung und Verlauf > Offline-Notizen legt fest, wie viele Tage an Notizen aufbewahrt werden (standardmäßig 5, bis zu 30, 0 schaltet Offline-Notizen aus), und zeigt, was der aktuelle Browser enthält.
• Grenzen: höchstens 300 Notizen und 50 MB Text, die zuletzt geänderten zuerst. Auch Dateien werden aufbewahrt: die in diesen Notizen angezeigten Bilder und alle Anhänge (PDF, Audio, Dateien) der Favoriten und der mit Offline behalten markierten Notizen, bis zu 25 MB pro Datei, 400 Dateien und 200 MB insgesamt, und nie mehr als die Hälfte des freien Speicherplatzes des Browsers. Eine größere Datei bleibt nur online, und die Notiz weist offline darauf hin.
• Voraussetzungen: Poznote muss über HTTPS bereitgestellt werden (Browser halten Seiten nur über eine sichere Verbindung offline bereit, http://localhost funktioniert ebenfalls) und nach der Anmeldung einmal online im Browser geöffnet worden sein, damit die Kopie angelegt wird.
• Datenschutz: Nur die Notizen Ihres eigenen Kontos werden aufbewahrt, nicht die eines mit Ihnen geteilten Kontos oder Arbeitsbereichs. Sie werden unverschlüsselt im Browser gespeichert. Die Abmeldung entfernt sie aus dem Browser (auch noch nicht gesendete Änderungen, nach einer Warnung, die sie auflistet): Melden Sie sich an einem gemeinsam genutzten Computer ab, wenn Sie gehen. Die Abmeldung funktioniert auch ohne Netzwerk über die Offline-Seite: Die Notizen werden sofort entfernt, und die Sitzung auf dem Server endet, sobald Poznote das nächste Mal online geöffnet wird.

Die 📦 Sicherung als Poznote-ZIP-Datei erzeugt eine eigenständige Offline-Version Ihrer Notizen. Entpacken Sie einfach die ZIP-Datei und öffnen Sie index.html in einem beliebigen Webbrowser. So können Sie Ihre Notizen offline lesen, allerdings ohne den vollen Funktionsumfang von Poznote: Es handelt sich um einen schreibgeschützten Export.

Backend

• PHP 8.5: Serverseitige Skriptsprache
• SQLite 3: Leichtgewichtige, dateibasierte relationale Datenbank

Frontend

• HTML5: Markup und Struktur
• CSS3: Gestaltung und responsives Design
• JavaScript (Vanilla): Interaktive Funktionen und dynamische Inhalte
• Vite: Build-Toolchain für die Komponenten Excalidraw (React) und CodeMirror (als IIFE gebündelt)
• AJAX: Asynchrones Laden von Daten

Bibliotheken

• CodeMirror 6: Erweiterbarer Code- und Texteditor für die Bearbeitung von Markdown
• Excalidraw: Virtuelles Whiteboard zum Skizzieren von Diagrammen und Zeichnungen
• Mermaid: Clientseitige JavaScript-Bibliothek zur Erzeugung von Diagrammen und Flussdiagrammen aus Text
• KaTeX: Clientseitige JavaScript-Bibliothek für schnellen mathematischen Formelsatz und die Darstellung mathematischer Gleichungen
• Sortable.js: JavaScript-Bibliothek für Sortieren per Drag-and-drop
• Lucide: Icon-Set der gesamten Oberfläche
• Devicon: Symbole der Programmiersprachen in Codeblöcken
• highlight.js: Syntaxhervorhebung für Codeblöcke
• Swagger UI: Interaktive Oberfläche zur API-Dokumentation und zum Testen

Speicherung

• HTML-/Markdown-Dateien: Notizen werden als einfache HTML- oder Markdown-Dateien im Dateisystem gespeichert
• SQLite-Datenbank: Metadaten, Tags, Beziehungen und Benutzerdaten
• Dateianhänge: Im lokalen Dateisystem oder optional in einem S3-kompatiblen Objektspeicher gespeichert

Infrastruktur

• Nginx + PHP-FPM: Leistungsstarker Webserver mit FastCGI Process Manager
• Alpine Linux: Sicheres, schlankes Basis-Image
• Docker: Containerisierung für einfache Bereitstellung und Portabilität
• Supervisor: Startet Nginx, PHP-FPM und die Hintergrund-Worker (Erinnerungen, geplante Backups)
• Python 3.12 (Alpine): Laufzeitumgebung des MCP-Servers mit den Bibliotheken httpx, uvicorn und fastmcp für die Integration von KI-Assistenten