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 from 1 day to full product delivery

Jetty : The Definitive Reference

Revision History
Revision 9.0.0.M3 2012-11-20 09:28:24
This documentation is produced and contributed to under the EPL

Welcome to the Jetty Documentation Hub!

This documentation is for Jetty 9 and is a work in progress, initially being largely structural and increasingly being populated with meaningful content.

The version as indicated above containing SNAPSHOT are updated frequently by an automated process while versions that contain M#, RC#, or v#### are durable releases for a specific version of Jetty.

If you need documentation on a previous release of Jetty the following list should direct you where you need to go.

This documentation is a community effort and is hosted at GitHub and we invite contributors to fork the repository and contribute! More information can be found in the Documentation section.

Table of Contents

I. Quick Start Guide
1. Introducing Jetty
What is Jetty?
What version do I use?
2. Quick Start Jetty
Download Jetty
Running Jetty
Deploying Web Applications
3. Quick Start Configuration
How to Configure Jetty
What to Configure in Jetty
II. Jetty Configuration Guide
4. Configuring Jetty Connectors
Connector Configuration Overview
Configuring SSL
Setting Port 80 Access for a Non-Root User
5. Configuring Contexts
Setting a Context Path
Setting Context Path to / (root)
Configuring Virtual Hosts
Creating Custom Error Pages
Serving a WebApp from a Particular Port
Configuring Form Size
6. Deploying Jetty
Webapp Layout
Using the Deployment Manager
Setting Deployment Bindings
Hot Deployment
Deploying WebApps
Using the Context Provider
Using the WebApp Provider
7. Configuring JSP Support
Configuring JSP
8. Jetty Logging
Configuring Jetty Request Logs
Sifting Logs with Logback
9. Configuring WebSockets
Configuring WebSockets
10. Security Topics
III. Advanced Topics Guide
11. Session Management
Setting Session Characteristics
Using Persistent Sessions
12. JNDI
Configuring JNDI
JNDI Datasource Examples
13. JMX
Using Java Management Extensions (JMX)
14. Starting Jetty
Start Features
Start Option Matrix
15. Maven and Jetty
Configuring the Jetty Maven Plugin
Jetty and Maven HelloWorld
16. Handlers
Writing Custom Handlers
17. Embedding
Embedding Jetty
Jetty HelloWorld
Configuring the Jetty Overlay Deployer
18. Frameworks
Spring Setup
OSGI Setup
19. Optimizing Jetty
Garbage Collection
High Load
20. Troubleshooting
Troubleshooting Zip Exceptions
Preventing Memory Leaks
IV. Jetty Client Guide
21. Incoming Documentation
Sample Title
22. Incoming Documentation
Sample Title
23. Incoming Documentation
Sample Title
V. Reference Guide
24. Architecture
Jetty 7 Architecture
Jetty Classloading
25. Contributing to Jetty
Community
Documentation
Coding Standards
Contributing Patches
Releasing Jetty
Testing a Jetty Release
26. Reference Section
jetty.xml
jetty-web.xml
jetty-env.xml
webdefault.xml
Jetty override-web.xml
Jetty XML Syntax
Jetty XML Usage
27. Upgrading Jetty
28. Frequently Asked Questions

List of Tables

1.1. Jetty Versions
2.1. Contents
4.1. Connector configuration
7.1. Understanding JSP 2.1 Parameters
8.1. GitHub Example Project
11.1. Init Parameters
12.1. Storing DataSources
24.1.
24.2.
See an error or something missing?
Contribute to this documentation at Github!