configuration¶
vb configuration SUBCOMMAND [OPTIONS]
Description¶
Get and set repository or global options. Where SUBCOMMAND is one of: export import merge pull push reset.
Options¶
- --proxy PROXY¶
Use PROXY as http proxy during sync operation (used by pull, push and sync subcommands)
- -R, --repository REPO¶
Affect repository REPO with changes
Subcommands¶
vb configuration export¶
vb configuration export AREA FILENAME
Description¶
Write to FILENAME exported configuration information for AREA. AREA can be one of:
all email interwiki project shun skin
ticket user alias subscriber
vb configuration import¶
vb configuration import FILENAME
Description¶
Read a configuration from FILENAME, overwriting the current configuration.
vb configuration merge¶
vb configuration merge FILENAME
Description¶
Read a configuration from FILENAME and merge its values into the current configuration. Existing values take priority over values read from FILENAME.
vb configuration pull¶
vb configuration pull AREA [URL]
Description¶
Pull and install the configuration from a different server identified by URL. If no URL is specified, then the default server is used. Use the –overwrite flag to completely replace local settings with content received from URL.
vb configuration push¶
vb configuration push AREA [URL]
Description¶
Push the local configuration into the remote server identified by URL. Admin privilege is required on the remote server for this to work. When the same record exists both locally and on the remote end, the one that was most recently changed wins.
vb configuration reset¶
vb configuration reset AREA
Description¶
Restore the configuration to the default. AREA as above.
vb configuration sync¶
vb configuration sync AREA [URL]
Description¶
Synchronize configuration changes in the local repository with the remote repository at URL.
See Also¶
Examples¶
Export and reset project configuration
$ vb configuration export project cfg.json
$ vb configuration reset project
Configuration reset to factory defaults.
To recover, use: vb configuration import config-backup-20260331130011.942
Merge exported config back
$ vb sys cat cfg.json
# The "project" configuration exported from
# repository "/tmp/sphinx_tests/a6822dd8/cfg_repo/cfg_repo.vbyte"
# on 2026-03-31 13:00:11
config /config 34
1774962011 'hash-policy' value '3'
$ vb configuration merge cfg.json