Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Note that while Jetty 9.x theoretically allowed for configuration directly within its distribution directory, Jetty 10 requires the recommended home/base split; the distribution itself is always considered read-only.

The examples on this page are based
Info
Note

Do NOT skip the Getting Started section. All of the example material depends on the use of a number of files that are not included in the Jetty distribution but are part of the java-idp-jetty-base project we store in our Git repository, which can be cloned via :
git clone https://git.shibboleth.net/git/java-idp-jetty-base
The examples won't work as is without starting from that complete set of example files. The 10 branch contains the files used in this material.

We may publish it in a more "official" capacity in the future, but for now it's simply an example to build on. It includes some custom Jetty "modules" that help support a simpler configuration.

Version Notes

The latest stable version of Jetty should be used.

Jetty 10 requires Java 11 or later, and also supports Java 17.

...

have to be downloaded and installed to create an initial jetty-base directory tree.

Version Notes

The latest stable version of Jetty should be used.

Jetty 10 requires Java 11 or later, and also supports Java 17.

Starting from scratch is advisable if upgrading from 9.x, although the changes from 9.4 are not all that extensive except in the area of logging.

Getting Started

The examples on this page are based on the use of a number of files that are not included in the Jetty distribution but are part of the java-idp-jetty-base project we store in our Git repository. The examples won't work as is without starting from that complete set of example files. The 10 branch contains the files used in this material.

The following commands (Linux-style) will get you to the starting point assumed from the examples in this page:

Code Block
$ git clone https://git.shibboleth.net/git/java-idp-jetty-base
$ cd java-idp-jetty-base
$ git checkout 10
$ cp -r src/main/resources/jetty-base /my/desired/location/

Required Configuration

The bulk of the configuration is established by setting properties in "ini" files that are combined in the start.d directory. Some of the properties are defined by Jetty and configure built-in modules and others are specific to the IdP and configure the custom modules we created.

...