Skip to main content

Backup & Restore

homescreen-hero lets you export, import, and revert your configuration from the Settings > Backup tab. This is useful for keeping backups before making big changes, migrating to a new server, or sharing a configuration between instances.

Export​

Click Export Config to download your current config.yaml as a file named config_backup_{date}.yaml.

caution

The exported file includes any sensitive values stored directly in config.yaml (API keys, tokens, etc.). Values set via environment variables are not included in the export, which is one more reason to use them for secrets.

Import​

Upload a .yaml or .yml file to replace your current configuration.

  1. Select a config file
  2. Click Validate to check the file for errors without applying it
  3. If validation passes, click Import Config to apply

Your current config is automatically backed up before the import is applied, so you can always revert if something goes wrong.

Revert​

If you need to undo an import, click Revert to Previous Config. This swaps your current config with the backup that was created during the last import.

Reverting is itself reversible- the configs are swapped, so you can revert again to get back to where you were.

note

Only one backup is kept at a time. Each import overwrites the previous backup.