Blog

Brad Wood

December 21, 2017

Spread the word


Share your thoughts

As Christmas draws near, remember to pick up batteries for all those toys.  There's nothing worse than a Christmas morning with not enough AA's.  In fact, there's solid evidence that this entire holiday is a ruse to keep battery manufacturers in business.  They're probably kahoots with the peppermint latte guys.  Anyhoo, let's talk quickly about using custom versions of Java with CommandBox.  

Custom Java Version

Some people (who will remain nameless) are on older versions of ColdFusion 9 (you know who you are!) and they are stuck back in the dark ages of Java 1.7.  Other people are already in the future with Java 9 on their machine, but whoops -- nothing actually works on Java 9 yet!  No to worry, we've got a way for you to dial in just what you need.

For the CLI

The core CommandBox CLI needs Java 7 or 8 right now.  Whether you're on *nix or Windows, the CLI will employ several kinds of dark magic to divine what the current installed version of Java is on your machine.  If your default Java version is not what you want and you don't want to change it (or perhaps you don't even have Java installed!) then you can hint to the CLI by simply placing a folder named "JRE" in the same directory as the box binary file.  When CommandBox starts, it looks for this folder and uses it as the JRE if it exists.  Inside the "JRE" folder should be a "bin" folder and the "bin" folder should have the "java" binary.  Double check that if it's not getting picked up for some reason.  You might just have an extra folder nested in there.

For your server

By Default, your servers start using the same version of Java that the CommandBox CLI is using. For people needing to run Adobe ColdFusion 9, or who just want to do some testing on different JREs, you can point each of your servers at a custom JRE and CommandBox will use it when starting the server.

server set jvm.javaHome="C:\Program Files\Java\jdk1.8.0_25"

To set the default version of Java for all the servers you start on your machine, use the global config setting defaults.

config set server.defaults.jvm.javaHome="C:\Program Files\Java\jdk1.8.0_25"

 

Add Your Comment

(1)

Oct 20, 2018 21:40:48 UTC

by Stewart McGuire

Brad, you should make a note that the folder in the /usr/local/bin folder for the JRE in linux should be "jre" not "JRE". I just discovered that. I actually created it as a symlink to my OpenJDK that I just installed along side my 1.10. Now my CommandBox is using 1.8.

Recent Entries

BoxLang v1.9.0 : Production-Ready Stability, Enhanced Lifecycle Management, and Rock-Solid Reliability

BoxLang v1.9.0 : Production-Ready Stability, Enhanced Lifecycle Management, and Rock-Solid Reliability

Happy New Year! The BoxLang team is excited to announce BoxLang 1.9.0, a significant stability and compatibility release focused on production-readiness thanks to our client migrations and new application deployments. This release also introduces array-based form field parsing conventions, enhanced datasource lifecycle management, improved context handling, and resolves over 50 critical bugs to ensure enterprise-grade reliability for mission-critical applications.

Luis Majano
Luis Majano
January 09, 2026
DocBox v5 - Reborn: Modern API Docs for BoxLang & CFML

DocBox v5 - Reborn: Modern API Docs for BoxLang & CFML

Welcome to DocBox v5! We didn't just update DocBox. We rebuilt it from the ground up.

DocBox v5.0.0 represents a complete architectural rewrite—modern syntax, blazing performance, and a stunning new look that finally brings API documentation into 2025. Gone are the clunky HTML pages of yesteryear. Say hello to a gorgeous, theme-driven single-page application that makes browsing your API docs feel like using a premium developer tool. We have also released a dedicated module for BoxLang: BX-DOCBOX. A fully interactive CLI tool for generating your docs from the command line using pure BoxLang.

Luis Majano
Luis Majano
January 06, 2026