Einstellungen

Frost speichert seine Einstellungen in config.toml in seinem Konfigurationsordner. Du kannst sie mit frost init, frost config set oder frost config edit ändern, oder in einem beliebigen Texteditor.

#Einstellungen lesen und ändern

Befehl	Wirkung
`frost config`	Gibt alle Einstellungen aus. Zugangsdaten sind maskiert, außer du fügst `--show-secrets` hinzu
`frost config get <key>`	Gibt eine Einstellung aus. Listen erscheinen mit einem Eintrag pro Zeile
`frost config set <key> <value...>`	Ändert eine Einstellung und zeigt, was sich geändert hat
`frost config edit [editor]`	Öffnet `config.toml` in einem Editor

Zum Beispiel:

frost config get schedule.every
frost config set schedule.every 6h
frost config set paths ~/Documents ~/Pictures

Eine Liste nimmt einen Wert pro Eintrag, und set ersetzt die ganze Liste.
true und false schalten Einstellungen ein und aus.
Eine Änderung an einer schedule-Einstellung aktualisiert den geplanten Auftrag sofort. Unter macOS und Windows wird eine Änderung, die du während eines geplanten Backups machst, übernommen, sobald dieses fertig ist, damit es nicht abbricht.
Änderst du den Ort deines Speichers, prüft Frost den neuen Ort, bevor es ihn speichert. Siehe Backups verschieben.

#Die Datei bearbeiten

frost config edit

Frost öffnet eine Kopie von config.toml im angegebenen Editor, ansonsten in $VISUAL oder $EDITOR, und sonst in nano, vim oder vi. Unter Windows ist Notepad (Editor) die Ausweichlösung. Wenn du den Editor schließt, listet Frost auf, was du geändert hast, und speichert die Kopie, sobald du yes eintippst.

Lässt sich die Datei nicht einlesen, zeigt dir Frost das Problem und bietet an, sie erneut zu öffnen. Ein Tippfehler kann deine geplanten Backups also nicht lahmlegen. Unbekannte Einstellungen gelten als Fehler, damit ein falsch geschriebener Name nicht unbemerkt durchrutscht.

#Selbst bearbeiten

Du kannst config.toml auch in einem beliebigen Texteditor öffnen und speichern. Frost liest die Datei bei jedem Start, daher gelten die meisten Änderungen ab dem nächsten Lauf. Zwei Arten von Änderungen brauchen einen Schritt mehr, den Frost beim nächsten Frost-Befehl erledigt, egal welchem:

Ein geänderter Zeitplan aktualisiert den geplanten Auftrag, und Frost meldet „config.toml changed. Scheduled job updated“ (config.toml wurde geändert, geplanter Auftrag aktualisiert). Unter Linux erledigt das auch das nächste geplante Backup. Eine Änderung während eines geplanten Backups wartet, bis es fertig ist, genau wie mit frost config set.
Ein neuer Speicherort bekommt beim ersten Gebrauch dieselben Prüfungen wie mit frost config edit. Probleme erscheinen als Warnungen.

Vor dem Speichern prüft nichts die Datei. Lässt sie sich nicht einlesen, melden Frost-Befehle das, bis du sie korrigierst.

#Alle Einstellungen

Schlüssel	Standard	Bedeutung
`paths`		Die Ordner, die gesichert werden
`exclude`	`.DS_Store`, `Thumbs.db`, `.tmp`, `.swp`, `node_modules`, `.cache`	Namen und Muster, die ausgelassen werden. Siehe Dateien ausschließen
`schedule.enabled`	`true`	Automatisch sichern
`schedule.every`	`daily`	`hourly`, `2h`, `3h`, `4h`, `6h`, `8h`, `12h`, `daily` oder `weekly`
`schedule.time`	`15:00`	Die Uhrzeit der Backups im 24-Stunden-Format. Siehe Automatische Backups
`schedule.day`	`sunday`	Der Tag wöchentlicher Backups, `sunday` bis `saturday`
`schedule.catch_up`	`true`	Ein verpasstes Backup nachholen, sobald dein Computer wieder da ist. `false` überspringt verpasste Backups
`verify.sample`	`20`	Wie viele Blöcke die Stichprobenprüfung herunterlädt. `0` schaltet sie aus
`update.auto`	`true`	Neue Versionen nach geplanten Backups installieren. `false` informiert nur darüber
`storage.backend`		`permafrost`, `s3`, `sftp` für Eigener Server oder `local` für ein lokales Laufwerk
`storage.sftp.host`		Die SSH-Adresse deines Servers, zum Beispiel `me@nas.local`, oder ein `Host` aus deiner SSH-Konfiguration
`storage.sftp.port`	`0`	Der SSH-Port des Servers. `0` nimmt den Port aus deiner SSH-Konfiguration oder 22
`storage.sftp.path`	`frost`	Der Ordner auf dem Server. Ein relativer Pfad beginnt in deinem Home-Ordner dort
`storage.local.path`		Der vollständige Pfad des Ordners auf einem Laufwerk
`storage.permafrost.url`		Leer für den Standardserver, `https://permafrost.wihiaawb.com`. Sonst eine `https://`-Adresse, oder `http://` für einen Server auf deinem eigenen Computer
`storage.permafrost.token`		Dein Permafrost-Zugriffsschlüssel
`storage.s3.endpoint`		Etwa `s3.us-east-1.amazonaws.com`. Eine vollständige `https://`-Adresse geht auch, und eine `http://`-Adresse schaltet TLS aus
`storage.s3.region`		Leer, wenn dein Server oder Anbieter keine Regionen nutzt
`storage.s3.bucket`		Der Name des Buckets. Er muss schon existieren
`storage.s3.prefix`	`frost`	Der Ordner im Bucket, der deine Backups enthält. Leer für die oberste Ebene des Buckets
`storage.s3.access_key_id`		Deine Zugriffsschlüssel-ID
`storage.s3.secret_access_key`		Dein geheimer Zugriffsschlüssel
`storage.s3.insecure`	`false`	Unverschlüsseltes HTTP für Endpunkte ohne Protokollangabe verwenden. Nur für lokale Tests

#Umgebungsvariablen

Variable	Ersetzt
`FROST_S3_ACCESS_KEY_ID` oder `AWS_ACCESS_KEY_ID`	`storage.s3.access_key_id`
`FROST_S3_SECRET_ACCESS_KEY` oder `AWS_SECRET_ACCESS_KEY`	`storage.s3.secret_access_key`
`FROST_PERMAFROST_TOKEN`	`storage.permafrost.token`
`FROST_CONFIG_DIR`	Den Konfigurationsordner, wie `--config-dir`
`FROST_CACHE_DIR`	Den Cache-Ordner

Frost schreibt Werte aus der Umgebung nie in config.toml. Geplante Backups sehen die Variablen nicht, die du in deiner Shell setzt, und brauchen die Zugangsdaten deshalb weiterhin in config.toml.