Version: 9.4.2.v20170220 |

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).`

### 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-02-20)