From Wiki
Revision as of 16:41, 24 February 2015 by Jakeh (Talk | contribs) (How do I access my Lucee Web Administator page?)

Jump to: navigation, search


Lucee is an open-source CFML engine and the successor of Railo. We proudly support Lucee in our environment, and more info about its background and usage is below.


The Lucee project was forked from Railo 4.2 in January 2015 and is owned by Lucee Association Switzerland. Though development on Railo has halted, Lucee will eventually inherit the enhancements planned for Railo 5. Currently Lucee operates the same as the latest available version of Railo, so you can migrate your Railo codebase to it without any surprises.

See these blogs for more info on the switch from Railo to Lucee:

Usage / Resources

For information about Lucee please reference the Lucee wiki. Specifically, the Lucee Cookbook has lots of good info about getting started.

If you're new to CFML in general, the following resources will help you get learn the basics:

How do I access my Lucee Web Administator page?

The preferred way to access your site's Lucee Web Administrator is by clicking the Web Administrator link within your control panel. Alternatively, you may access it by appending /lucee/admin/web.cfm to the end of your site's domain name or testing URL.

I'm redirected to another page on my site when accessing the Lucee Web Administrator

If your site uses rewrite rules to make your site's links search-engine-friendly, then you'll need to make a small adjustment to your rewrite rules. Add the following line to your site's .htacess file to allow your Lucee Web Administrator to load properly:

RewriteEngine On
RewriteCond %{REQUEST_URI} !^.*/(lucee)($|/.*$) [NC]
RewriteRule ^(.*)$ - [NC,L]

That code will tell the rewrite engine to ignore requests that contain the word lucee. If your site already has a similar RewriteCond in its .htacess file (common with CF Wheels or ColdBox), then just add lucee to the list of URIs to bypass.

How do I create a datasource within Lucee?

You may create Lucee datasources (DSNs) either withing your site's Lucee Web Administrator or within the site's Application.cfc. More info on creating Lucee datasources is in this Lucee Cookbook entry: How to define a Datasource