# 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:

```sh
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](#moving-backups).

## Die Datei bearbeiten

```sh
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](#excluding-files) |
| `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](#scheduling) |
| `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](#self-hosted) oder `local` für ein [lokales Laufwerk](#local-drive) |
| `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`.