geoserver/README.md

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 downloading and extracting the war file
   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

• CORS
• 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?