Jetty/Howto/Install Jetty/Bundle

Introduction

This howto provides detailed instructions for downloading and installing the latest version of Jetty 7. If you just want to get up and running, see the Quick Start Guide.

Prerequisites

Hardware

• ~7 MB of disk space for Jetty source
• ~7 MB for Jetty 7 binaries

Operating System

• Any operating system that supports J2SE 1.5 or greater.

Environment

• J2SE 1.5 or greater

Steps

Download the Binary

Download the latest Jetty core component binary from the Jetty downloads page.

Unpack the Binary

Unzip the binary; it will be extracted into a directory called jetty-distribution-VERSION. Put this directory into a convenient location. The rest of the instructions in this wiki will refer to this location as either JETTY_HOME or as $(jetty.home).

That's it! The Jetty binary is now available for you to use. You may now choose to either run Jetty or configure Jetty.

Distribution Contents

Here's a quick rundown of the distribution's contents, to help you familiarize yourself with it. The top-level directory should look like:

about.html  contexts            etc   javadoc  LICENSE-APACHE-2.0.txt    logs      notice.html  resources  webapps
bin         contexts-available  lib   LICENSE-ECLIPSE-1.0.html  META-INF  README.txt   start.jar

about.html 

"About This Content" page from Eclipse

bin 

directory for shell scripts to help automate the building and running of Jetty

contexts 

hot deploy directory

contexts-available 

directory for additional example contexts

etc 

directory for Jetty configuration files

javadoc 

contains the javadoc; needs to be built first

lib 

contains all the JAR files necessary to run jetty-7

LICENSE-APACHE-2.0.TXT 

license file for Jetty (Jetty 7 is dual-licensed)

LICENSE-ECLIPSE-1.0.HTML 

license file for Jetty (Jetty 7 is dual-licensed)

logs 

directory for request logs

META-INF 

for packaging

notice.html 

licenses applicable to Jetty, as well as any exceptions

README.TXT 

contains useful getting started information

resources 

directory containing additional resources for configuration

start.jar 

JAR which invokes jetty-7 (see also How to Run Jetty)

webapps 

directory containing webapps which will be run under the default configuration of Jetty; contains demo webapps