docker-library
/
docs
mirror of https://github.com/docker-library/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
docs/jetty
History
yosifkit a8e245a749 Merge pull request #175 from md5/jetty-user-setuid 
Document use of `setuid` module and user `jetty`
 		2015-03-03 08:25:27 -08:00
..
README-short.txt Shorten README-short.txt to under 100 characters 2015-02-06 16:19:08 -08:00
README.md Merge pull request #175 from md5/jetty-user-setuid 2015-03-03 08:25:27 -08:00
content.md Fix documentation of JETTY_STATE location 2015-02-28 00:10:14 -08:00
license.md FORMAT ALL THE THINGS 2015-02-12 13:42:10 -07:00
logo.png Shrink logo to fit in 200x200 2015-02-06 16:20:23 -08:00

README.md

Supported tags and respective Dockerfile links

For more information about this image and its history, please see the relevant manifest file (library/jetty) in the docker-library/official-images GitHub repo.

What is Jetty?

Jetty is a pure Java-based HTTP (Web) server and Java Servlet container. While Web Servers are usually associated with serving documents to people, Jetty is now often used for machine to machine communications, usually within larger software frameworks. Jetty is developed as a free and open source project as part of the Eclipse Foundation. The web server is used in products such as Apache ActiveMQ, Alfresco, Apache Geronimo, Apache Maven, Apache Spark, Google App Engine, Eclipse, FUSE, Twitter's Streaming API and Zimbra. Jetty is also the server in open source projects such as Lift, Eucalyptus, Red5, Hadoop and I2P. Jetty supports the latest Java Servlet API (with JSP support) as well as protocols SPDY and WebSocket.

wikipedia.org/wiki/Jetty_(web_server)

logoLogo © Eclipse Foundation

How to use this image.

Run the default Jetty server (CMD ["jetty.sh", "run"]):

docker run -d jetty:9

You can test it by visiting http://container-ip:8080 in a browser or, if you need access outside the host, on port 8888:

docker run -d -p 8888:8080 jetty:9

You can then go to http://localhost:8888 or http://host-ip:8888 in a browser.

The default Jetty environment in the image is:

JETTY_HOME    =  /usr/local/jetty
JETTY_BASE    =  /var/lib/jetty
JETTY_CONF    =  /usr/local/jetty/etc/jetty.conf
JETTY_STATE   =  /var/lib/jetty/jetty.state
JETTY_ARGS    =
JAVA_OPTIONS  =
TMPDIR        =  /tmp

Webapps can be deployed in /var/lib/jetty/webapps.

Security

By default, this image starts as user root and uses Jetty's setuid module to drop privileges to user jetty after initialization. The JETTY_BASE directory at /var/lib/jetty is owned by jetty:jetty (uid 999, gid 999).

If you would like the image to start immediately as user jetty instead of starting as root, you can start the container with -u jetty:

docker run -d -u jetty jetty:9

License

View license information for the software contained in this image.

Supported Docker versions

This image is officially supported on Docker version 1.5.0.

Support for older versions (down to 1.0) is provided on a best-effort basis.

User Feedback

Issues

If you have any problems with or questions about this image, please contact us through a GitHub issue.

You can also reach many of the official image maintainers via the #docker-library IRC channel on Freenode.

Contributing

You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.

Before you start to code, we recommend discussing your plans through a GitHub issue, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.