Version: 9.4.7.v20170914 |

Chapter 2. Using Jetty
Previous | Part I. Getting Started With Jetty Home | Next

##### 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

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:

> 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-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

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

### 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 http://central.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.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)

Previous | Top | Next
Finding Jetty in Maven | Home | Running Jetty

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