Hudson-ci/Containers/Winstone

Hudson Continuous Integration Server
Website
Download
Community
Mailing List • Forums • IRC • mattermost
Issues
Open • Help Wanted • Bug Day
Contribute
Browse Source

	Using Winstone as a Container

Update Needed!
With the Eclipse move, Winstone is no longer the default container, so this page applies only to Hudson 2.n

Installation

Hudson ships with Winstone, so no additional installation needed. Just run with java -jar hudson.war.

Notes

• Running behind Apache with AJP
• List of available command line options for example to change the HTTP port

Setting HUDSON_HOME

Specify the -D option to the invocation:

$ java -DHUDSON_HOME=/path/to/home -jar hudson.war

Or if that fails for some reason, you should still be able to use the environment variable:

$ export HUDSON_HOME=/path/to/hudson_home
$ java -jar hudson.war

Securing Hudson on Winstone

Winstone supports pluggable authentication as explained here. For example, to use FileRealm, you'd do:

$ cat users.xml
<tomcat-users>
<role rolename="admin"/>
<user username="joe" password="secret" roles="admin"/>
</tomcat-users>
$ java -jar hudson.war --realmClassName=winstone.realm.FileRealm --fileRealm.configFile=users.xml