Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


titleTable of Contents
Table of Contents


Unix and Mac Installation

Hudson needs Java J2SE 1.5 or later to run. Hudson is released as a single WAR file. The easiest way to use Hudson is to use Hudson's built in Winstone servlet container. Download Hudson, and execute Hudson by running java -jar hudson.war. This is basically the same setup as the test drive except that Hudson log messages will be sent to the console window.

Alternatively, if you have a servlet container that supports Servlet 2.4/JSP 2.0 or later, such as Glassfish, Tomcat 5, JBoss, Jetty 6, etc. Then, you can deploy Hudson's WAR file as you would any other war file. Container specific documentation is available if you choose this route.

Top of page

Windows Installation

If you're running on Windows you might want to run Hudson as a service so it starts up automatically without requiring a user to log in. The easiest way is to install Tomcat as a service, and then deploy Hudson to it. Another way is to use the Java Service Wrapper which is described in the Installing Hudson as a Windows service section.

Top of page

Case Studies

Also, see how other people are deploying Hudson to get some idea of how to make it fit your environment.

Top of page


As mentioned above, the easiest way to execute Hudson is through the built in Winstone servlet container. You can execute Hudson like this:


To see Hudson, simply bring up a web browser and go to URL http://*myServer:8080{*} where myServer is the name of the system running Hudson.

Top of page

Command Line Parameters

Hudson normally starts up using port 8080, however, if you have other web services starting up, you might find that this port is already taken, you can specify a different port by using the --httpPort=$HTTP_PORT where color:green}$HTTP_PORT is the port you want Hudson to run on. Other command line parameters include: