Nota betreiben
Nota ist ein Programm und eine SQLite-Datei, und du betreibst es selbst.
Ein Programm
Abschnitt betitelt „Ein Programm“| Befehl | Was es ist |
|---|---|
nota init [ordner] | eine neue Installation einrichten |
nota serve | der 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|revoke | Schlüssel |
nota pair, nota device list|revoke | Telefone |
Zwei kleine Server genügen
Abschnitt betitelt „Zwei kleine Server genügen“- 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.
Vor dem Internet
Abschnitt betitelt „Vor dem Internet“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.
Schlüssel und Rollen
Abschnitt betitelt „Schlüssel und Rollen“Ein Schlüssel hat eine von drei Rollen:
| Rolle | Darf |
|---|---|
ingest | melden |
read | lesen |
operate | lesen und einen Brief senden |
./nota token add laptop read./nota token list./nota token revoke laptopEin Schlüssel wird einmal angezeigt; gespeichert wird nur sein Hash.
Umgebung
Abschnitt betitelt „Umgebung“| Variable | Bedeutung | Standard |
|---|---|---|
NOTA_DB | Datenbankdatei | ./nota.db |
NOTA_LISTEN | Adresse, auf der es lauscht | 127.0.0.1:8080 |
NOTA_CONF | Ordner mit *.json-Konfigurationsdateien | ./conf.d |
NOTA_FORWARD_URL | optionale Senke: jede angenommene Meldung, NDJSON über HTTP, nach bestem Bemühen | — |
NOTA_FORWARD_TOKEN | Bearer-Schlüssel für diese Senke | — |
NOTA_PUBLIC_URL | die Adresse, unter der Telefone diesen Core erreichen; steht in Kopplungs-Links | — |
NOTA_RELAY_URL | Push-Relay für gekoppelte Telefone; off schaltet Push ab | https://relay.notabrief.com, das noch nicht läuft |
NOTA_PROBE | die Konfiguration der Sonde, die in serve mitläuft; off für keine | ./probe.json, wenn es sie gibt |
Konfigurationsdateien
Abschnitt betitelt „Konfigurationsdateien“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.
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.
Daten und Sicherung
Abschnitt betitelt „Daten und Sicherung“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:
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.
Sicherheit im Entwurf
Abschnitt betitelt „Sicherheit im Entwurf“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.