56 lines
1.9 KiB
Markdown
56 lines
1.9 KiB
Markdown
# 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](Dockerfile)
|
|
1. installs dependencies
|
|
1. installs the GeoServer by downloading and extracting the war file
|
|
1. defines defaults for environment variables
|
|
1. The [entrypoint.sh](scripts/entrypoint.sh) startup script (in a running container)
|
|
1. executes [install-extensions.sh](scripts/install-extensions.sh) to download and install GeoServer extensions based on the `STABLE_EXTENSIONS` environment variable.
|
|
1. handles the `GEOSERVER_OPTS`
|
|
1. 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?
|