Dockerized GeoServer.
- Built on top of Docker's official tomcat image. Using
tomcat:9-jre17
as base for versions 2.23.1 and above, andtomcat:9-jdk11
for versions below 2.23.1. - Running tomcat process as non-root user.
- Separate GEOSERVER_DATA_DIR location (on /var/local/geoserver).
- Configurable extensions.
- Injectable UID and GID for better mounted volume management.
- CORS ready.
- Taken care of JVM Options.
- Automatic installation of Microsoft Core Fonts for better labelling compatibility.
- Custom geoserver deployment path
- docker health check
Latest versions with automated builds available on docker registry:
Security patches for older versions:
2.23.6
(2.23.6/Dockerfile)2.22.5
(2.22.5/Dockerfile) Latest with JDK 112.21.5
(2.21.5/Dockerfile)2.20.7
(2.20.7/Dockerfile)2.19.7
(2.19.7/Dockerfile)2.18.7
(2.18.7/Dockerfile)
Other experimental dockerfiles (not automated build):
oracle
. Uses wnameless/oracle-xe-11g, needs ojdbc7.jar and setting up a database. See the run commands.h2-vector
. Plays nicely with oscarfonts/h2:geodb, and includes sample scripts for docker-compose and systemd.ecw
. Adding GDAL plugin with ECW support.
Think of them more as recipes or documentation rather than production-ready builds :)
Get the image:
docker pull oscarfonts/geoserver
Run as a service, exposing port 8080 and using a hosted GEOSERVER_DATA_DIR:
docker run -d -p 8080:8080 -v ${PWD}/data_dir:/var/local/geoserver oscarfonts/geoserver
- On build time, set the GEOSERVER_PATH arg to change the geoserver base path. It defaults to
/geoserver
.
The tomcat user uid and gid can be customized with CUSTOM_UID
and CUSTOM_GID
environment variables, so that the mounted data_dir and exts_dir are accessible by both geoserver and a given host user. Usage example:
docker run -d -p 8080:8080 -e CUSTOM_UID=$(id -u) -e CUSTOM_GID=$(id -g) oscarfonts/geoserver
To add extensions to your GeoServer installation, provide a directory with the unzipped extensions separated by directories (one directory per extension):
docker run -d -p 8080:8080 -v ${PWD}/exts_dir:/var/local/geoserver-exts/ oscarfonts/geoserver
You can use the build_exts_dir.sh
script together with a extensions configuration file to create your own extensions directory easily.
Warning: The
.jar
files contained in the extensions directory will be copied to theWEB-INF/lib
directory of the GeoServer installation. Make sure to include only.jar
files from trusted sources to avoid security risks.
It is also possible to configure the context path by providing a Catalina configuration directory:
docker run -d -p 8080:8080 -v ${PWD}/config_dir:/usr/local/tomcat/conf/Catalina/localhost oscarfonts/geoserver
See some examples.
CORS is configured automatically in the servlet web.xml filters. If you have another
component in front that already takes care of it you can disable it with the environment variable
-e "GEOSERVER_CORS_ENABLED=false"
.
It is also possible to fine tune it for specific origins, methods, etc. with the following variables:
GEOSERVER_CORS_ALLOWED_ORIGINS
(cors.allowed.origins)GEOSERVER_CORS_ALLOWED_METHODS
(cors.allowed.methods)GEOSERVER_CORS_ALLOWED_HEADERS
(cors.allowed.headers)GEOSERVER_CORS_URL_PATTERN
(filter-mapping url-pattern)
See Tomcat documentation for more info.