Zum Inhalt springen

Nota betreiben

Nota ist ein Programm und eine SQLite-Datei, und du betreibst es selbst.

BefehlWas es ist
nota init [ordner]eine neue Installation einrichten
nota serveder Core; mit einer probe.json daneben auch die Sonde
nota probe [-check|-once] <config.json>die Sonde allein — auf einem zweiten Rechner, mit dem Blick von außen
nota token add|list|revokeSchlüssel
nota pair, nota device list|revokeTelefone
  • Auf dem ersten nota serve: Core und Sonde in einem Prozess.
  • Auf dem zweiten nota probe: Sie prüft von außen und beobachtet den ersten. Siehe eine zweite Sonde.

Ein Rechner geht auch. Er kann dir dann nicht sagen, dass er nicht erreichbar ist.

Der Core lauscht lokal, auf 127.0.0.1:8080. Davor gehört ein Reverse-Proxy mit TLS. Öffne / fürs Dashboard und melde dich mit einem Schlüssel der Rolle read oder operate an.

Die Sitzung ist der Schlüssel in einem Cookie mit HttpOnly und SameSite=Strict, und jede Anfrage, die etwas ändert, muss vom selben Ursprung kommen.

Ein Schlüssel hat eine von drei Rollen:

RolleDarf
ingestmelden
readlesen
operatelesen und einen Brief senden
Terminal-Fenster
./nota token add laptop read
Terminal-Fenster
./nota token list
Terminal-Fenster
./nota token revoke laptop

Ein Schlüssel wird einmal angezeigt; gespeichert wird nur sein Hash.

VariableBedeutungStandard
NOTA_DBDatenbankdatei./nota.db
NOTA_LISTENAdresse, auf der es lauscht127.0.0.1:8080
NOTA_CONFOrdner mit *.json-Konfigurationsdateien./conf.d
NOTA_FORWARD_URLoptionale Senke: jede angenommene Meldung, NDJSON über HTTP, nach bestem Bemühen—
NOTA_FORWARD_TOKENBearer-Schlüssel für diese Senke—
NOTA_PUBLIC_URLdie Adresse, unter der Telefone diesen Core erreichen; steht in Kopplungs-Links—
NOTA_RELAY_URLPush-Relay für gekoppelte Telefone; off schaltet Push abhttps://relay.notabrief.com, das noch nicht läuft
NOTA_PROBEdie Konfiguration der Sonde, die in serve mitläuft; off für keine./probe.json, wenn es sie gibt

Jede *.json-Datei in NOTA_CONF darf Regeln, Brief-Vorlagen (actions), Ziele für Benachrichtigungen, deklarierte Dinge und Preise je Ereignis enthalten; die Dateien werden zusammengeführt. SIGHUP lädt sie neu; bei einer fehlerhaften Konfiguration gilt die vorige weiter.

Terminal-Fenster
kill -HUP $(pidof nota)

Eine Oberfläche für die Konfiguration gibt es nicht. Ein Coding-Agent schreibt sie dir in einer Minute; das Dashboard zeigt, was gilt. Die Schlüsselwörter stehen in der Referenz.

Alles liegt in einer SQLite-Datei (NOTA_DB). Nota speichert Zustände und Übergänge, keine Zeitreihen: Von einem Messwert bleiben der letzte Wert und ein Tag Verlauf. Vorfälle bleiben 400 Tage.

Zum Sichern kopierst du die Datei konsistent, zum Beispiel mit dem Backup-Befehl von SQLite:

Terminal-Fenster
sqlite3 nota.db ".backup 'nota-backup.db'"

Sichere den Konfigurationsordner, probe.json und deine Listen mit. Langzeit-Historie von Messwerten gehört in eine Senke (NOTA_FORWARD_URL), nicht in Nota.

Nota liest. Es führt nichts aus, ändert keine Netzwerke und durchsucht keine Logs. Das Einzige, was es sendet, ist ein signierter Aufruf mit einem Text an eine Adresse, die du hinterlegt hast: eine Benachrichtigung oder ein Brief.

Etwas gefunden? Sicherheitsmeldungen.