The HTTP server will run on the port specified by the
lucee-base/start.ini config file - changes to this file require a Jetty
restarted to be picked up.
On Unix-based systems, for historical reasons, ports below 1024 require root permissions, so to listen on the default HTTP port 80, the Jetty documentation has various options at: Setting Port 80 Access for a Non-Root User.
To enable HTTPS with Jetty, you need to:
lucee-base/etc/keystorefile containing SSL certificate data.
lucee-base/etc/jetty-ssl-context.xmlcontaining KeyStorePath and KeyStorePassword configuration.
ssl-reloadmodule to avoid the need to restart when etc/keystore is updated.
For each individual site you should create a new webapp context - there are a
few ways to do this with Jetty, but the easiest is to open the
lucee-base/webapps/ROOT.xml file, modify the
resourceBase (webroot) and
virtualHosts (domain aliases) as appropriate, and save it as a new XML file.
This is done by adding items to the virtualHost array in a webapp context. For example, the default ROOT.xml has this:
<Set name="virtualHosts"> <Array type="String"> <Item>localhost</Item> <Item>127.0.0.1</Item> </Array> </Set>
But you might have a context set to:
<Set name="virtualHosts"> <Array type="String"> <Item>myluceesite.dev</Item> <Item>www.myluceesite.dev</Item> </Array> </Set>
You can set wildcard subdomains, use punycode for non-ASCII domain names, and more: Configuring Virtual Hosts.
Upgrading Jetty is as simple as stopping the server, remove or rename the existing jetty-home directory, and put the new downloaded Jetty distribution in its place, then start the server again.
(Alternatively, instead of renaming the directories you can simply update the start-server script to point at the start.jar in the new Jetty directory.)
Lucee has its own upgrade functionality built-in - either via the Server Admin,
or by placing an lco patch in the
If it is necessary to do a full manual upgrade, you need to stop the server
and replace the contents of
modules/lucee/lib with a new Lucee JAR download.
Lucee on Jetty is an on-going project and this documentation is not yet complete.
To prioritise what gets added, please do request missing documentation via the issue tracker, or via email.