The image is based on the official Tomcat 9 image
This image is available as a trusted build on the docker hub, and is the recommended method of installation.
Simple pull the image from the docker hub.
$ docker pull geonode/geoserver
Alternatively you can build the image locally
$ git clone https://github.com/geonode/geoserver-docker.git $ cd geoserver-docker $ docker build -t "geonode/geoserver" .
You can quick start the image using the command line
$ docker run --name "geoserver" -d -p 8080:8080 geonode/geoserver
Point your browser to
http://localhost:8080/geoserver and login using GeoServer's default username and password:
- Username: admin
- Password: geoserver
How to use different versions
There are mainly two different versions of this image which are useful for running GeoNode with different authentication system types. These versions are released as specific tags for two authentication mechanisms:
You can declare what version to use along with the data directory tag corresponded to the same version.
This GeoServer container keeps its configuration data at
/geoserver_data/data which is exposed as volume in the dockerfile.
The volume allows for stopping and starting new containers from the same image without losing all the data and custom configuration.
You may want to map this volume to a directory on the host. It will also ease the upgrade process in the future. Volumes can be mounted by passing the
-v flag to the docker run command:
Data volume container
In case you are running Compose for automatically having GeoServer up and running then a data volume container will be mounted with a default preloaded GEOSERVER_DATA_DIR at the configuration data directory of the container.
Make sure that the image from the repository data-docker is available from the GeoNode Docker Hub or has been built locally:
docker build -t geonode/geoserver_data .
If you run:
Data are retained in the GEOSERVER_DATA_DIR and can then be mounted in a new GeoServer instance by running again:
If you run:
Data are completely gone but you can ever start from the base GeoServer Data Directory built for Geonode.
Data directory versions
There has to be a correspondence one-to-one between the data directory version and the tag of the GeoServer image used in the Docker compose file. So at the end you can consume these images below:
GeoServer recommends the usage of a spatial database
PostGIS container (PostgreSQL + GIS Extension)
$ docker run -d --name="postgis" kartoza/postgis
For further information see kartooza/postgis.
Now start the GeoServer instance by adding the
--link option to the docker run command: