diff --git a/jetty/README.md b/jetty/README.md index 947f45532..64475fe78 100644 --- a/jetty/README.md +++ b/jetty/README.md @@ -16,7 +16,7 @@ Jetty is a pure Java-based HTTP (Web) server and Java Servlet container. While W # How to use this image. -Run the default Jetty server (`CMD ["jetty.sh", "run"]`): +Run the default Jetty server: ```console $ docker run -d jetty:9 @@ -34,10 +34,6 @@ 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 = /run/jetty/jetty.state - JETTY_ARGS = - JAVA_OPTIONS = TMPDIR = /tmp/jetty ## Deployment @@ -46,6 +42,30 @@ Webapps can be [deployed](https://www.eclipse.org/jetty/documentation/current/qu For older EOL'd images based on Jetty 7 or Jetty 8, please follow the [legacy instructions](https://wiki.eclipse.org/Jetty/Howto/Deploy_Web_Applications) on the Eclipse Wiki and deploy under `/usr/local/jetty/webapps` instead of `/var/lib/jetty/webapps`. +## Configuration + +The configuration of the Jetty server can be reported by running with the `--list-config` option: + +```console +$ docker run -d jetty:9 --list-config +``` + +Configuration such as parameters and additional modules may also be passed in via the command line. For example: + +```console +$ docker run -d jetty:9 --modules=jmx jetty.threadPool.maxThreads=500 +``` + +To update the server configuration in a derived Docker image, the `Dockerfile` may enable additional modules with `RUN` commands like: + +```Dockerfile +FROM jetty:9 + +RUN java -jar "$JETTY_HOME/start.jar" --add-to-startd=jmx,stats +``` + +Modules may be configured in a `Dockerfile` by editing the properties in the corresponding `/var/lib/jetty/start.d/*.mod` file or the module can be deactivated by removing that file. + ## Read-only container To run `jetty` as a read-only container, have Docker create the `/tmp/jetty` and `/run/jetty` directories as volumes: