Public | Automated Build

Last pushed: 7 months ago
Short Description
Build geoserver docker image from update in git
Full Description


A simple docker container that runs Geoserver influenced by this docker
recipe: by Tim Sutton

This container is configured to build with:

  • Tomcat8.5
  • Openjdk 8
  • GeoServer 2.8.x / 2.9.x
  • GeoServer Plugins: Any plugins downloaded to /resources/plugins

Note: We recommend using apt-cacher-ng to speed up package fetching -
you should configure the host for it in the provided 71-apt-cacher-ng file.

Getting the image

The image can be downloaded from our image on dockerhub:

docker pull soprarnd/defra-rnd-geoserver


Geoserver Plugins

To build the GeoServer image with plugins (Control Flow, Monitor, Inspire, etc),
download the plugin zip files from the GeoServer download page and put them in
resources/plugins before building. You should make sure these match the version of
GeoServer you are installing.
GeoServer version is controlled by the variable in Dockerfile, or download the WAR bundle
for the version you want to resources/ before building.

Tomcat Extras

Tomcat is bundled with extras including docs, examples, etc. If you don't need these, set
the TOMCAT_EXTRAS build-arg to false when building the image. (This is the default in

docker build --build-arg TOMCAT_EXTRAS=false -t thinkwhere/geoserver-docker .


GeoServer is installed by default with the integrated GeoWebCache functionality. If you are using
the stand-alone GeoWebCache, or another caching engine such as MapProxy, you can remove the built-in GWC
by setting the DISABLE_GWC build-arg to true when building the image.

docker build --build-arg DISABLE_GWC=true -t thinkwhere/geoserver-docker .

Native JAI / JAI ImageIO

Native JAI and JAI ImageIO are included in the final image by default providing better
performance for raster data processing. Unfortunately they native JAI is not under active
development anymore. In the event that you face issues with raster data processing,
they can remove them from the final image by setting the JAI_IMAGEIO build-arg to false
when building the image.

docker build --build-arg JAI_IMAGEIO=false -t thinkwhere/geoserver-docker .

GDAL Image Formats support

You can optionally include native GDAL libraries and GDAL extension in the image to enable
support for GDAL image formats.

To include native GDAL libraries in the image, set the GDAL_NATIVE build-arg to true
when building the image.

docker build --build-arg GDAL_NATIVE=true -t thinkwhere/geoserver-docker .

To include the GDAL extension in the final image download the extension and place the zip
file in the resources/plugins folder before building the image. If you use the
script to build the image simply uncomment the relevant part of the script.

#if [ ! -f resources/plugins/ ]
#    wget -c -O resources/plugins/


External geoserver_data directory

You probably want to run Geoserver with an external geoserver_data directory mapped as a docker volume.
This allows the configuration to be persisted or shared with other instances. To create a running container
with an external volume do:

### Running multiple instances on the same machine
For installations with multiple containers on the same host, map port 8080 to a different port for each
instance.  It is recommended that the instance name contains the mapped port no for ease of reference.
Each instance should also have its own log file, specified by passing in the `GEOSERVER_LOG_LOCATION'
variable as illustrated in the example below.

docker build -t defrarnd/geoserver:latest .

docker run --name=geoserver -p 8080:8080 -d -t defrarnd/GeoServer

Setting Tomcat properties

To set Tomcat properties such as maximum heap memory size, create a
file such as:

JAVA_OPTS="$JAVA_OPTS -Djava.awt.headless=true -XX:+UseConcMarkSweepGC -XX:+CMSClassUnloadingEnabled"

Then pass the file as a volume at /usr/local/tomcat/bin/ when running:

docker run -d \
    -v $HOME/tomcat/ \

This repository contains a script for your convenience.

Using docker-compose

Docker-compose allows you to deploy a load-balanced cluster of geoserver containers with a single command. A sample docker-compose.yml configuration file is included in this repository, along with a sample nginx configuration file.

To deploy using docker-compose:

  1. copy nginx folder from this repository to your machine.
  2. copy tomcat_settings folder from this repository to your machine.
  3. copy docker-compose.yml to your machine. Edit the volume entries to reflect the correct location of your geoserver_data, nginx and tomcat_settings folders on your machine.
  4. type docker-compose up -d to start up a load-balanced cluster of 2x geoserver containers + nginx.
  5. access geoserver services at http://localhost/geoserver/wms?

Note: The default geoserver user is 'admin' and the password is 'geoserver'.
It is recommended that these are changed for production systems.

Docker Pull Command