Upgrading

CommandBox : CLI, Package Manager, REPL & More
Search…
Upgrading
CommandBox is a Java-based tool that involves several pieces including native Java classes, CFML code, and the embedded Railo CLI. However, most changes are confined to the CFML code managed by WireBox. To determine what version you have installed, use the version command.
1
box version
Copied!
The auto-upgrade commands shown below will not upgrade the main CommandBox Java Binary. If there are any major upgrades to this binary, you will see a message that you will need to download the new Java binary and replace your current one.
Stable
To upgrade to the last stable version of the shell and commands, use the upgrade command.
1
box upgrade
Copied!
This command will connect to our server to determine the last stable build. If there is an upgrade, it will be downloaded and installed for you.
Bleeding Edge
To upgrade to the bleeding edge version of the shell and commands, use the latest flag.
1
box upgrade --latest
Copied!
This command will connect to our server to determine the latest build. If there is an upgrade, it will be downloaded and installed for you.
Use The Force
If you already have the latest version installed, but you still want to force an upgrade, use the force parameter.
1
upgrade --force
2
upgrade --latest --force
Copied!
Brute Force
Note, if you delete your {user}/.CommandBox folder and re-run the executable, the version of CommandBox in the executable will be unpacked regardless of any upgrades you may have installed in the mean time. On that note, another way to force an upgrade is to simply download the new executable, wipe the .CommandBox folder in your user directory and re-run. This will also erase any saved command history, embedded servers, or installed user commands.
Mac/  *Unix
If you have used Hombrew to install CommandBox you must use Homebrew for any upgrade, minor or major. To upgrade CommandBox with Homebrew:
1
brew upgrade commandbox
Copied!
Non-Oracle JREs
Common Errors
Last modified 5mo ago
Copy link
Contents