Jetty Logo
Version: 9.4.5.v20170502
Contact the core Jetty developers at www.webtide.com

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

Chapter 2. Using Jetty

Table of Contents

Downloading Jetty
Running Jetty
Deploying Web Applications

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.

Downloading Jetty

Downloading the Jetty Distribution

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.

Distribution Content

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

Table 2.1. Contents

LocationDescription

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


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:

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.2. Contents

LocationDescription

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)


See an error or something missing? Contribute to this documentation at Github!(Generated: 2017-05-02)