jetty-installing.adoc

Downloading Jetty

Downloading the Jetty Distribution

The standalone Jetty distribution is available for download from the Eclipse Foundation:

Jetty https://www.eclipse.org/jetty/download.html

It is available in both zip and gzip formats; download the one most appropriate for your system. When you download and unpack the binary, it is extracted into a directory called jetty-home-VERSION. Put this directory in a convenient location. The rest of the instructions in this documentation refer to this location as either $JETTY_HOME or as $(jetty.home).

Important

It is important that only stable releases are used in production environments. Versions that have been deprecated or are released as Milestones (M) or Release Candidates (RC) are not suitable for production as they may contain security flaws or incomplete/non-functioning feature sets.

Distribution Content

A summary of the distribution’s contents follows. The top-level directory contains:

Table 1. Contents

Location	Description
license-eplv10-aslv20.html	License file for Jetty
README.txt	Useful getting started information
VERSION.txt	Release information
bin/	Utility shell scripts to help run Jetty on Unix systems
demo-base/	A Jetty base directory to run a Jetty server with demonstration webapps
etc/	Directory for Jetty XML configuration files
lib/	All the JAR files necessary to run Jetty
logs/	Directory for request logs
modules/	Directory of module definitions
notice.html	License information and exceptions
resources/	Directory containing additional resources for classpath, activated via configuration
start.ini	File containing the arguments that are added to the effective command line (modules, properties and XML configuration files)
start.jar	Jar that invokes Jetty (see also [quickstart-running-jetty])
webapps/	Directory containing webapps that run under the default configuration of Jetty

Downloading the Jetty-Home Distribution

Jetty-Home is an alternate version of the distribution that contains only the necessary items to host a Jetty distribution. It is intended for advanced users who are already familiar with Jetty and want to download a smaller distribution package. Jetty-Home can be downloaded from the Maven Central repository:

Jetty-Home https://repo1.maven.org/maven2/org/eclipse/jetty/jetty-home/

Like the main Jetty distribution, Jetty-Home is available in both zip and gzip formats; download the one most appropriate for your system. Notice that there are a number of other files with extensions of .sha or .md5 which are checksum files. When you download and unpack the binary, it is extracted into a directory called jetty-home-VERSION. Put this directory in a convenient location.

Distribution Content

A summary of the Jetty-Home’s distribution contents follows. The top-level directory contains:

Table 2. Contents

Location	Description
license-eplv10-aslv20.html	License file for Jetty
VERSION.txt	Release information
etc/	Directory for Jetty XML configuration files
lib/	All the JAR files necessary to run Jetty
modules/	Directory of module definitions
notice.html	License information and exceptions
start.jar	Jar that invokes Jetty (see also [quickstart-running-jetty])