Multi-Engine Support
You can specify the CFML engine via the command line arguments:
1
CommandBox> start cfengine=[email protected]
Copied!
This will start an Adobe ColdFusion 2018 server in your webroot. That's it!
By default, CommandBox uses the cfengine slug to search for the engine on ForgeBox. The format is [email protected] where the version is optional. Ortus Solutions maintains the versions of the engines available on ForgeBox.
Supported engines are:
    Adobe ColdFusion 9 **
    Adobe ColdFusion 10
    Adobe ColdFusion 11
    Adobe ColdFusion 2016
    Adobe ColdFusion 2018
    Adobe ColdFusion 2021
    Railo 4.2
    Lucee 4.5
    Lucee 5
Here are some examples:
1
# Start the default engine
2
CommandBox> start
3
4
# Start the latest stable Railo engine
5
CommandBox> start cfengine=railo
6
7
# Start a specific engine and version
8
CommandBox> start cfengine=[email protected]
9
10
# Start the most recent Adobe server that starts with version "11"
11
CommandBox> start cfengine=[email protected]
12
13
# Start the most recent adobe engine that matches the range
14
CommandBox> start cfengine="[email protected]>9.0 <=11"
Copied!
Engines are downloaded and stored in your CommandBox artifacts folder. You can view your engines and clear them using the standard artifacts commands:
1
CommandBox> artifacts list
2
3
# Removes all adobe servers currently in the artifacts
4
# These servers will need to be re-downloaded the next time they are started
5
CommandBox> artifacts remove adobe
Copied!
** Note: Adobe ColdFusion 9 does not support the latest Java 8. To run ColdFusion 9 you must use an older version of CommandBox 3.x on Java 7 or run CommandBox 4.x on Java 8 update 92 or earlier. Several people are doing this, but beware your mileage may vary.

ColdFusion Admin settings

While Lucee asks for a password the first time running the admin, ColdFusion requires a username and password when CommandBox sets it up. The default username and password for the Adobe ColdFusion servers used are:
    Username: admin
    Password: commandbox

WAR Support

Additionally, CommandBox can start any WAR given to it using the WARPath argument.
1
CommandBox> start WARPath=/var/www/myExplodedWAR
2
CommandBox> start WARPath=/var/www/myWAR.war
Copied!
If you run a regular start command inside of a folder that has a /WEB-INF/web.xml file, CommandBox will treat that folder as a WAR.

Custom Engines

The cfengine parameter can accept any valid CommandBox endpoint ID. That means it can be an HTTP URL, a Git repo, a local folder path to your company's network share, or a custom ForgeBox entry you've created. As long as that endpoint resolves to a package that contains these files, you're good:
    1.
    box.json
    2.
    Engine.[zip|war] (file name doesn't matter)
CommandBox will download the package, unzip it and use the WAR/zip file as the engine for your app.
Normally, the artifacts cache isn't used for non-ForgeBox packages, but CommandBox will only download the engine once per server and then assume the file hasn't changed. You will need to forget the server to trigger a new download.
Here's an example of starting up a web server using a direct download link to a package containing a WAR file:
1
CommandBox> start cfengine=http://downloads.ortussolutions.com/adobe/coldfusion/9.0.2/cf-engine-9.0.2.zip
Copied!

server.json Configuration

You can set the cfengine and other related configuration options in your server.json to use them every time you start your app.
1
CommandBox> server set app.cfengine=adobe
2
CommandBox> server set app.WARPath=/var/www/my-app
Copied!
These commands would create the following server.json
1
{
2
"app":{
3
"cfengine":"adobe",
4
"WARPath":"/var/www/my-app"
5
}
6
}
Copied!
Just a reminder that starting a server with any command line arguments will save the arguments to your server.json by default.
1
CommandBox> start cfengine=[email protected]
Copied!
This command would add [email protected] to your server.json. If this is not what you want, you can append saveSettings=false or even --!saveSettings when you start your server and CommandBox will not save the arguments you specify to your server.json.
Last modified 5mo ago