Version: 9.4.5.v20170502 |
private support for your internal/customer projects ... custom extensions and distributions ... versioned snapshots for indefinite support ... scalability guidance for your apps and Ajax/Comet projects ... development services for sponsored feature development
Table of Contents
You can use Jetty in many different ways ranging from embedding Jetty in applications, launching it from different build systems, from different JVM-based languages, or as a standalone distribution. This guide covers the latter, a standalone distribution suitable for deploying web applications.
The standalone Jetty distribution is available for download from the Eclipse Foundation:
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-distribution-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.
A summary of the distribution’s contents follows. The top-level directory contains:
Table 2.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 Running Jetty) |
webapps/ | Directory containing webapps that run under the default configuration of Jetty |
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:
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.
A summary of the Jetty-Home’s distribution contents follows. The top-level directory contains:
Table 2.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 Running Jetty) |