Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Jetty/Starting/Quick Start Guide
Contents
Introduction
The following provides quick instructions for downloading, installing, and running the latest binary version of Jetty 7. The table at the end of this page provides links to instructions for other versions of Jetty.
Prerequisites
Hardware
- 7.1 MB of disk space for Jetty source
- 7.3 MB for Jetty 7 binaries
Operating System
- Any operating system that supports J2SE 1.5 or greater.
Environment
- J2SE 1.5 or greater
Download and Unpack
- Download the latest Jetty from Eclipse. From the download site, select the version you want and follow the prompts to Save it on your system.
- Unzip it into a directory of your choice. Now it is ready to start running.
Starting Jetty
To start Jetty open a command shell, go to your Jetty installation directory, and type:
java -jar start.jar
This starts Jetty running on port 8080.
Jetty will not start if another process is using port 8080. The port number can be changed by editing the $JETTY_HOME/etc/jetty.xml file. Please see the #Setting Jetty's Port section below or for more details see Configuring Jetty. The rest of the instructions in this wiki will assume that you are using port 8080
Stopping Jetty
From the command shell where Jetty is running type: <ctrl-c>.
Testing Jetty
When Jetty starts, it deploys a test web application on port 8080. To check if Jetty is running properly navigate to the test URL from a browser. For example:
http://localhost:8080/test
Setting Jetty's Port
To change Jetty's default port, edit $JETTY_HOME/etc/jetty.xml and change the port number in this line, then start Jetty:
<Set name="port"><SystemProperty name="jetty.port" default="8080"/></Set>
Alternatively you can set the port on the command line. Please see Configuring Jetty for more details.
Installation Instructions for Other Versions
To install and run the version you downloaded, locate your version in the table and follow the instructions:
Version | Installation Instructions |
---|---|
Jetty-7 source | Building from Source |
Jetty-6 or older source | Building from Source |
Jetty-6 or older binaries | Using the binary |
Jetty RPM | Using the Jetty RPMs |
Jetty DBM | Jetty Debian Packages |
Hightide | Quick Start Guide |