Docker GeoServer image

This docker GeoServer image is based on the following proposal:

https://github.com/geoserver/geoserver/wiki/GSIP-192

Work is still in progress!

How it works

1. The Dockerfile
   1. installs dependencies
   2. installs the GeoServer by adding a ZIP and extracting the WAR from it
      1. the expected file name of the war in the zip is geoserver.war
      2. by default, the GeoServer URL from sourceforge is used, but you could also provide a custom URL with a zip in the GEOSERVER_WAR_SRC build argument.
      3. you can also use the GEOSERVER_WAR_SRC build argument to burn your custom WAR file from your local machine to the docker image, e.g. with something like docker build -t geoserver:test --build-arg GEOSERVER_WAR_SRC="./resources/geoserver.zip" .
   3. defines defaults for environment variables
2. The entrypoint.sh startup script (in a running container)
   1. executes install-extensions.sh to download and install GeoServer extensions based on the STABLE_EXTENSIONS environment variable.
   2. handles the GEOSERVER_OPTS
   3. starts the tomcat

Quickstart

You can quickstart by using the docker-compose demo

docker-compose -f docker-compose-demo.yml up --build

(use sudo if you get problems with mounted geoserver data dir)

Building

docker build -t geoserver:test .

Running

docker run -it -e DOWNLOAD_EXTENSIONS='true' -e STABLE_EXTENSIONS='wps,csw' -p 8080:8080 geoserver:test

The extensions will be downloaded on startup of the image (before starting the tomcat).

Configuration

Pass as environment variables. If not passed, the default values will be used.

• GEOSERVER_DATA_DIR (default: /opt/geoserver_data)
• INITIAL_MEMORY (default: 2G)
• MAXIMUM_MEMORY (default: 4G)
• JAIEXT_ENABLED (default: true)
• DOWNLOAD_EXTENSIONS (default: false)
  • STABLE_EXTENSIONS applies only if DOWNLOAD_EXTENSIONS is true: provide a comma separated list of extension identifiers and they will be downloaded and installed on startup (default: "")

TODOs

• configuration of JNDI connections in the tomcat/custom tomcat configuration in general
• default data for gs datadir?
• log4j properties
• add possibility to add custom fonts
• starting from which version we want to provide geoserver images/backwards compatability?