View source for Jetty/Howto/Run Jetty

{{Jetty Howto
| introduction = 

{{Jetty Redirect|http://www.eclipse.org/jetty/documentation/current/quickstart-running-jetty.html}}

This howto covers how to start up Jetty as standalone, and links to pages which cover alternative methods of startup.
| steps =
===Standalone Startup===

====Using the Start.jar====

The easiest way to start Jetty, is to use the start.jar that comes with the distribution.

<source lang="bash">
java -jar start.jar
</source>

The default options may be specified in the start.ini file, or if that is not present, they are defined in the start.config file that is within the start.jar.

To see the command line options for start.jar and help text for start.jar use:
<source lang="bash">
java -jar start.jar --help
</source>

For a full description of start.jar features see [[Jetty/Feature/Start.jar|Jetty Start.jar Feature Guide]].

====More start.jar examples ====

To run jetty with all options enabled:

<source lang="bash">  
java -jar start.jar OPTIONS=All
</source>

To run with JSP support (if available)

<source lang="bash"> 
java -jar start.jar OPTIONS=Server,jsp
</source>

To run with JMX support

<source lang="bash"> 
java -jar start.jar OPTIONS=Server,jmx etc/jetty-jmx.xml etc/jetty.xml
</source>

To run with JSP & JMX support

<source lang="bash"> 
java -jar start.jar OPTIONS=Server,jsp,jmx etc/jetty-jmx.xml etc/jetty.xml
</source>



===Alternative Startup Techniques===

====Embedded Startup====
Jetty can be configured and started as an embedded webapp server from within another Java program. See [[Jetty/Tutorial/Embedding_Jetty|Embedding Jetty Tutoral]] for more details.   Once you have a main that runs Jetty, it is very easy to run this from your IDE, debugger and/or profiler.

====Eclipse Startup====

Jetty can be started up from within Eclipse using a variety of techniques; see [[Jetty/Howto/Use Jetty with Eclipse|How to Use Jetty with Eclipse IDE]] for details.

====Jetty Maven Plugin====

You can run jetty directly on your maven webapp project - without even needing to assemble it into a war - see [[Jetty/Feature/Jetty Maven Plugin | The Jetty Maven Plugin]] for details.

====Jetty Ant Plugin====

You can run jetty directly on your ant webapp project - see [[Jetty/Howto/Use Jetty with Ant|The Jetty Ant Plugin]] for details.

====Jetty Runner====

You can run jetty from a single jar file on one or more webapps and contexts using the [[Jetty/Howto/Using Jetty Runner|Jetty Runner Jar]].

====JUnit Startup====

}}