Download and Installing Lucee

Download and Install Lucee Server

Lucee can be installed and run almost everywhere that is capable of running a supported Java Version. You can even run Lucee on a small RasberryPI. Because of it's great flexibility, Lucee Server comes in different flavors to match your needs (Lucee Express, Lucee Installer, CommandBox, Lucee.jar/Lucee.war). This document will help you decide which one fits best for your purpose.

Option 1: Lucee Express (ZIP-File)
Description:
Lucee Express allows you to quickly test Lucee without installing. This version runs Lucee in a lightweight and portable manner. It doesn't install Java Development Kit (JDK), services nor connectors or other files that are typically installed in a production environment. Lucee Express also ships Tomcat with fewer binaries/scripts. By default the Lucee Express listens on port 8888 (e.g. http://localhost:8888).
OS:
Windows, Linux, MacOS
Download:
Download the latest Lucee Express Release version here.
Includes:
Lucee Express ships:
- Lucee.jar (Servlet Container)
- Tomcat (Java Servlet Engine)
Best for:
Lucee Express is typically used for testing and for local development that doesn't need a fronted webserver.
Instructions:
Simply download the zip file, unzip that file and execute path-to-lucee-express\bin\startup.bat (Windows) or path-to-lucee-express/bin/startup.sh (Linux or Mac), that's all!
Note:
To run Lucee Express you still need to have a Java Development Kit (e.g. AdoptOpenJDK) pre installed on your OS. If you don't want to install a JDK on your OS and instead run Lucee Express with its own dedicated JDK version, you can set the JRE_HOME environment variable pointing to that specific JDK version by using Tomcats path-to-lucee-express\bin\setenv.bat (Windows) or path-to-lucee-express/bin/setenv.sh (Linux) as follows:

Step 1: Download the latest Java Development Kit, e.g. AdoptOpenJDK as ZIP-Version for your OS and unzip it.
Step 2: For Windows: Create a batch file at path-to-lucee-express\bin\setenv.bat with the following content:
REM set a path to a dedicated JDK 
set "JRE_HOME=path-to-your-jdk\"
exit /b 0
For Linux/MacOS: Create a shell script at path-to-lucee-express\bin\setenv.sh with the following content:
# Set set a path to a dedicated JDK 
JRE_HOME=/path-to-your-jdk/
CATALINA_PID="$CATALINA_BASE/tomcat.pid"
Step 3: To run Lucee Express execute path-to-lucee-express\bin\startup.bat (Windows) or path-to-lucee-express/bin/startup.sh (Linux or Mac).
For further information, please refer to Tomcats 9.0 Documentation (see 3.4)


Option 2: Lucee Installer (.exe/.run binaries files)
Description:
Lucee Installer is the recommended "all in one" solution for a typical production installation with minimal manual configuration, including service and connectors for fronted webservers ( Apache on Linux / IIS on Windows ). It installs its own dedicated Java Development Kit (AdoptOpenJDK) and comes with the option to install "mod_cfml" for Tomcat's automatic multiple website configuration.
OS:
Windows, Linux
Download:
Download the latest Lucee Installer Release version here.
Includes:
Lucee Installer ships:
- Lucee.jar (Servlet Container)
- Tomcat (Java Servlet Engine)
- AdoptOpenJDK (Java Development Kit)
- mod_cfml (for Tomcat's automatic host and context configuration - More about mod_cfml
- Boncode Connector (for connecting IIS to Tomcat via AJP) - More about Boncode
Best for:
Lucee Installer is typically used for production environments where you want have a webserver, e.g. Apache or IIS, acting in front of Lucee/Tomcat and run Lucee as service.
Instructions:
On Windows: Run the Lucee Windows Installer file (.exe) as Administrator on a Windows machine with IIS running, so that the installer can detect IIS and connect it with Lucee/Tomcat (Boncode AJP connector and mod_cfml)
On Linux: Run the Lucee Windows Installer file (.run) with sudo user/root on a Linux machine with Apache webserver running, so that the installer can detect Apache and connect it with Lucee/Tomcat (ReverseProxy and mod_cfml). You may need to give the .run file execute permission first to be able to execute it.
Note:
If you are missing the latest "Lucee Installer" Release at Lucee's download site and it's marked as "Coming soon", you can still install the latest available Lucee version with the following steps:
Step 1: Select the latest possible release that has a "Lucee Installer" version available and do the complete installation process.
Step 2: Stop the Lucee/Tomcat service.
Step 3: Download the latest "Lucee.jar" file at Lucee's download page here.
Step 4: Replace the old lucee.jar with the new downloaded Lucee.jar file at path-to-lucee-install/lib/.
Step 5: Delete the folder "lucee-server" at path-to-lucee-install/tomcat/lucee-server.
Step 6: Restart the Lucee/Tomcat service.


Option 3: CommandBox
Description:
Commandbox is a commandline tool that greatly simplifies installing and running Lucee. It's very likely the easiest way to run Lucee: Simply open a terminal session from within your webroot, enter the command line 'box server start' and CommandBox will start the latest stable Lucee instance running your web application.
CommandBox makes use of it's own servlet engine "Undertow" that can be customized through a single .json configuration file. But that's not all you get with CommandBox: Because CommandBox is also a package manager, you can also install and run usefool tools for your CFML development, such as "cfconfig", "CFLint", "taskRunner", "testBox", "CFFormat" or use it to install popular CFML frameworks in a modern scaffolding manner.
OS:
Windows, Linux, MacOS
Download:
Please see the CommandBox Download-Page
Best for:
CommandBox can be used for local development and for production environments. One of the main characteristics of CommandBox is, that it uses one single CommandBox/Undertow instance per webroot/web application.
Instructions:
Please refer to CommandBox Start Guide


Option 4: Custom Installation (Lucee.jar/Lucee.war)
Description:
Lucee.jar is the pure stand alone servlet containers of Lucee as compressed Java ARchive (also known as JAR-file) and Lucee.war is a Web application ARchive (also known as WAR-file) containing the Lucee.jar. Use these files if you want to run Lucee in different environments with different servlet engines (e.g. Undertow, Jetty or cloud based servlet engines like AWSElasticBeanstalk).
You may also use Lucee.jar for upgrading/downgrading Lucee installations without a complete re-installation by simply replacing the .jar file in the servlets engine library folder. If so, please make always sure to backup Tomcat, all server- and web-contexts and your configurations before upgrading.
Download:
Download the latest Lucee.jar or Lucee.war Release version here.
Includes:
- Lucee.jar (Servlet Container as JARchive File) or
- Lucee.war (WARchive containing also Lucee.jar)
Best for:
Custom Installation is used for other environments running Java Servlet Engines or Java Web Application Archives, such as Undertow, Jetty, cloud based servlet engines like AWSElasticBeanstalk and others.


Java Versions Supported

  • The Official Lucee Installer comes with Java 11, which is our recommended version
  • Java 8 is still officially supported for 5.3, with Lucee 6 it will be no longer officially supported, but will be unofficially, as long as feasible
  • Lucee Supports Java 9 since version 5.3.0.57
  • Java 16 is not currently supported due to breaking internal changes with the jvm, LDEV-3526

Java Support tips

  • When reporting a bug with Lucee, please always describe your stack (Lucee version, Java Version, Tomcat/etc version and the Extension version, if it's extension related)
  • If you aren't running the latest release of Java and encounter a problem, please try updating your Java version before reporting a bug, especially if it's several years old!

Using Lucee with multiple websites, mod_cfml

Lucee doesn't support multiple webserver hosts directly, however mod_cfml is available to achieve this. Mod_cfml is capable to identify new CFML web applications on the fronted webservers side, such as IIS on Windows or Apache on Linux, and automatically add the necessary configuration to your Lucee/Tomcat configuration.

Boncode AJP Connector

To connect Microsofts Internet Information Services (IIS) with Lucee/Tomcat the Lucee Installer uses the Boncode connector using Apache JServ Protocol (AJP). For further information about Boncode AJP, FAQs and troubleshooting, please refer to Boncode AJP Documentation

Developer Forum

If you do not find the answers you are looking for here, we encourage you to post to Lucee-Dev. There are many friendly members of the community who are willing to help:

Lucee Developer Forum