OpsVault

config

Create or edit the OpsVault configuration file interactively.

config

Launch the interactive terminal wizard to create or edit your config file. No manual YAML editing required.

opsvault config [flags]

If no config file exists yet, a default one is created automatically at the standard path before the wizard opens.

The wizard opens a full-screen TUI menu. Use ↑ ↓ arrows to navigate and Enter to select.

SectionWhat you can configure
General SettingsBackup directory, cron schedule, log level, log format
DatabasesAdd, edit, or remove MySQL / PostgreSQL database entries, set excluded tables
PathsAdd, edit, or remove directory/file backup entries, set preset and custom excludes
Storagerclone remote name, path template, upload options
RetentionHow many backups to keep locally and on the remote
NotificationsTelegram bot and SMTP email settings
Save & ExitWrite changes to the config file
Exit without savingDiscard all changes

Each section opens a sub-menu showing the current value of every field. Select any field to change only that value, then go back — you never have to step through fields you don't want to change.

The config file path is shown at the top of the main menu. You can also edit the file directly in any text editor.

Example

# Open the wizard (default path depends on user)
opsvault config

# Open a config at a custom path
opsvault config --config /home/user/opsvault.yaml

Default config path

WhoDefault path
root/etc/opsvault/config.yaml
non-root~/.config/opsvault/config.yaml

Both paths can be overridden with --config.

Passwords are never stored by the wizard. Use password env var fields (e.g. DB_PASS) — the wizard only stores the env var name, not the value.

On this page