Setting Sync
If you are authenticated to ForgeBox in the CLI, you can synchronize your config settings to and from your ForgeBox account. This is a great way to get up and running on a new PC, or keep multiple CommandBox installs in sync with each other. In addition to synchronizing your Config Settings, this feature will also track your installed system modules, such as CFConfig, etc.
In order to sync your settings and modules, you must first be logged into ForgeBox. Check and see if you are logged in with
If necessary, log in with
Now you can synchronize your settings.
config sync push
This command will push your local settings and modules up to your ForgeBox account.
By default, the settings are "merged" so new local settings will be added to ForgeBox, but nothing will be removed. In order to remove config that only exists on ForgeBox, you can use the --overwrite
flag to force a full sync.
config sync pull
This command will pull your settings and modules from your ForgeBox account and set/install them locally.
By default, the settings are "merged" so missing settings will be added locally and missing system modules will be installed, but nothing will be removed. In order to remove config and modules that only exists locally, you can use the --overwrite
flag to force a full sync. This will remove local config settings and uninstall local system modules which were not on ForgeBox.
config sync diff
This command will not change anything, but gives you a full report of all settings which are different between your local CommandBox CLI and ForgeBox. It will show you "Remote Only", "Local Only", and "Changed" settings and modules. Use this to see what you're about to change prior to pushing or pulling.
Automatic Sync of settings
If you are logged into ForgeBox and have a ForgeBox Pro account, your settings will automatically sync for you. If
the user is logged into forgebox
the user has a ForgeBox Pro account
the CLI is not in Offline mode
The autosync feature is not disabled
then CommandBox will auto-sync ForgeBox settings based on these rules
Pull new settings from ForgeBox when …
CLI Starts (interactive)
logging into forgebox
switching forgebox users
Push config to ForgeBox when…
config settings get updated
a system module is installed
a system module is uninstalled
The forgebox endpoint used will be
The endpoint configured in config settings for autosync
the configured default forgebox endpoint
“forgebox”
The following autosync settings can be used to control this.
configAutoSync.enable
configAutoSync.enable
Enable or disable autosync entirely.
configAutoSync.endpoint
configAutoSync.endpoint
Name of the ForgeBox endpoint to sync to. Only use this if you have a ForgeBox Enterprise account with your own custom ForgeBox URL.
configAutoSync.overwrite
configAutoSync.overwrite
Enable to disable whether syncing overwrites changes. See the docs for the overwrite
parameter to the config push and pull commands for more details. This setting basically just defaults that parameter.
Last updated