https://github.com/terrestris/docker-geoserver

A basic docker geoserver image with JAI and marlin renderer running on tomcat
https://github.com/terrestris/docker-geoserver

alpine alpine-image alpine-linux docker docker-geoserver docker-image geoserver tomcat

Last synced: about 2 months ago
JSON representation

A basic docker geoserver image with JAI and marlin renderer running on tomcat

• Host: GitHub
• URL: https://github.com/terrestris/docker-geoserver
• Owner: terrestris
• Created: 2017-12-16T15:41:16.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2024-11-18T18:31:06.000Z (2 months ago)
• Last Synced: 2024-11-18T19:39:35.715Z (2 months ago)
• Topics: alpine, alpine-image, alpine-linux, docker, docker-geoserver, docker-image, geoserver, tomcat
• Language: Scheme
• Homepage:
• Size: 4.7 MB
• Stars: 23
• Watchers: 4
• Forks: 20
• Open Issues: 8
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# A geoserver docker image

This Dockerfile can be used to create images for all geoserver versions since 2.5.

Based on [tomcat:9-jre11-openjdk-slim](https://hub.docker.com/_/tomcat):

* Debian based Linux

* OpenJDK 11

* Tomcat 9

* GeoServer

  * Native Java advanced imaging (JAI) is installed

  * [JAI-EXT](http://docs.geoserver.org/stable/en/user/configuration/image_processing/index.html#jai-ext) is enabled by default

  * Marlin renderer

  * Support of custom fonts (e.g. for SLD styling)

  * [GeoStyler](https://www.osgeo.org/projects/geostyler/) included

  * CORS support

**IMPORTANT NOTE:** Please change the default geoserver master password! The default masterpw is located in this file (within the docker container): `/opt/geoserver_data/security/masterpw/default/masterpw`

## How to build?

`docker build -t {YOUR_TAG} .`

## How to quickstart?

Build the image as described above, then:

`docker run -it -p 80:8080 {YOUR_TAG}`

or if you want to start the container daemonized:

`docker run -d -p 80:8080 {YOUR_TAG}`

Check http://localhost/geoserver to see the geoserver page and login with geoserver defaults `admin:geoserver`

## How to build a specific GeoServer version?

`docker build --build-arg GS_VERSION={YOUR_VERSION} -t {YOUR_TAG} .`

## How to build with custom geoserver data?

`docker build --build-arg GS_DATA_PATH={RELATIVE_PATH_TO_YOUR_GS_DATA} .`

**Note:** The passed path **must not** be absolute! Instead, the path should be within the build context (e.g. next to the Dockerfile) and should be passed as a relative path, e.g. `GS_DATA_PATH=./my_data/`

## Can I build a specific GS version with custom data?

Yes! Just pass the `--build-arg` param twice, e.g.

`... --build-arg GS_VERSION={VERSION} --build-arg GS_DATA_PATH={PATH} ...`

## How to build with additional libs/extensions/plugins?

Put your `*.jar` files (e.g. the WPS extension) in the `additional_libs` folder and build with one of the commands from above! (They will be copied to the GeoServer `WEB-INF/lib` folder during the build.)

**Note:** Similar to the GeoServer data path from above, you can also configure the path to the additional libraries by passing the `ADDITIONAL_LIBS_PATH` argument when building:

`--build-arg ADDITIONAL_LIBS_PATH={RELATIVE_PATH_TO_YOUR_LIBS}`

## How to add additional libs using an existing docker image?

If you want to add geoserver extensions/libs by using a mount, you can add something like

```

--mount src="/dir/with/libs/on/host",target=/opt/additional_libs,type=bind

```

## How to add additional fonts to the docker image (e.g. for SLD styling)?

If you want to add custom fonts (the base image only contains 26 fonts) by using a mount, you can add something like

```

--mount src="/dir/with/fonts/on/host",target=/opt/additional_fonts,type=bind

```

to your `docker run` command.

**Note:** Do not change the target value!

## How to watch geoserver.log from host?

`docker exec -it {CONTAINER_ID} tail -f /opt/geoserver_data/logs/geoserver.log`

## How to use the docker-compose demo?

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