Brad Wood

April 18, 2019

Spread the word

Share your thoughts

We've released a new major version of our CommandBox FusionReactor module.  This module allows you to easily add FusionReactor to any server you start with no manual installation or fiddling with JVM args.


install commandbox-fusionreactor
fr register "myLicenseKey"
server start

Debug Libs

One of the most-requested features is for it to include the JVM args that load the debugger libraries.  This new version of the module will do that automatically for you now unless you set fusionreactor.debugEnable to false in your server.json.  The debugger libs unlock additional functionality such as the production debugger, event snapshots, and heap analysis.  

Automatic Updates

One of the next most-common requests we would receive was for us to update the module to use the latest version of FusionReactor-- something that used to be manual.  FusionReactor is now maintained on ForgeBox automatically as part of Integral's build process so you can use the newest FusionReactor versions right away with no waiting and no effort.  Just restarting your server will be enough to trigger a download of the latest version automatically.  You'll never be behind again.

Pinning A Custom Version

The reason this is a major release is because there is a small backwards incompatibility with the previous version of the module now based on the fact that it installs the FR jar and debug libs from ForgeBox.  The "version" and "downloadURL" settings have been removed in favor of a new consolidated setting called "installID" which currently defaults to the following value internally:

installID : "fusionreactor@^8.0.0"

You may recognize that is the same format as when you use the "install" command in CommandBox to install packages from ForgeBox.  That is because it is exactly what you are looking at!  "fusionreactor" is the name of the new package on ForgeBox and "^8.0.0" is a semantic version range that will automatically match the latest stable 8.x version.  

If you want to dial into a specific version and/or skip the ForgeBox check on startup, you can remove the caret and dial in your version like so:

server set fusionreactor.installID="fusionreactor@7.4.4"

You can review the published versions on ForgeBox to see what is available to you.  And as you may have guessed, the "installID" can be ANY VALID CommandBox endpoint, meaning you can point to a custom HTTP URL, ForgeBox package, etc using any installation mechanism supported by the "install" command.  So long as the installation ID points to a package with the FR jar and debug libs, you're good to go!

Upgrading the Module

If you have an older version of the module currently installed, you cannot use "update --system" since this is a major bump.  Instead, explicitly request the latest to be installed like so:

install commandbox-fusionreactor

If you were not using the version or downloadURL settings, then you don't need to do anything in order to use the latest version.  It will be a drop-in replacement. If you were using the "version" setting, then update your configs to use the new installID setting in the format "fusionreactor@version".  Please note, Integral does not support old releases and opted to not add all old versions to ForgeBox to check the listing to see what versions are available to you. If you were using the downloadURL setting, update your URL target to be a proper package zip file with a box.json, fusionreactor.jar, and the debugging libs and move the HTTP url into the installID setting.  


Add Your Comment


Apr 19, 2019 07:55:55 UTC

by Charlie Arehart

Sweet stuff. Thanks for the efforts, guys: you especially on commandbox and forgebox and this integration, of course, and Integral as well for whatever they did for linking to forgebox and supporting the auto update process.

Recent Entries

CBWIRE 3.0.0 Released

CBWIRE 3.0.0 Released

We are very excited to announce the release of version 3 of CBWIRE, our ColdBox module that makes building modern, reactive apps a breeze. This version brings with it a new component syntax, 19 enhancements and bug fixes, and improved documentation. Our biggest goal with this release was to improve the developer experience and to provide a low barrier to entry to getting started with CBWIRE.

Grant Copley
Grant Copley
May 22, 2023
ColdBox 7.0.0 Released

ColdBox 7.0.0 Released

Introducing ColdBox 7: Revolutionizing Web Development with Cutting-Edge Features and Unparalleled Performance

We are thrilled to announce the highly anticipated release of ColdBox 7, the latest version of the acclaimed web development HMVC framework for ColdFusion (CFML). ColdBox 7 introduces groundbreaking features and advancements, elevating the development experience to new heights and empowering developers to create exceptional web applications and APIs.

Designed to meet the evolving needs of modern web development, ColdBox 7 boasts a range of powerful features that streamline the development process and enhance productivity. With its robust HMVC architecture and developer-friendly tools, ColdBox 7 enables developers to deliver high-performance, scalable, and maintainable web applications and APIs with ease.

Esme Acevedo
Esme Acevedo
May 16, 2023
TestBox v5.0.0 Released!

TestBox v5.0.0 Released!

We are excited to announced the release of Testbox version 5, which brings a host of new features and improvements for developers. TestBox is a powerful and flexible tool that helps developers write comprehensive BDD/TDD tests for their applications, ensuring code quality and reducing the likelihood of bugs and errors. With TestBox v5, developers can take advantage of new features such as batch code coverage testing, improved reporting capabilities, method spies, and better integration with other tools in the Ortus suite.

These new features make TestBox even more versatile and user-friendly, and provide developers with a powerful tool for building high-quality, reliable applications.


Luis Majano
Luis Majano
May 11, 2023