docker pull geonetwork 

# Quick reference

• Maintained by:
  GeoNetwork opensource

• Where to get help:
  the Docker Community Forums, the Docker Community Slack, or Stack Overflow

Supported tags and respective Dockerfile links

• 3.10.5, 3.10, 3, latest
• 3.10.5-postgres, 3.10-postgres, 3-postgres, postgres
• 3.8.3, 3.8
• 3.8.3-postgres, 3.8-postgres
• 4.0.1, 4.0, 4

Quick reference (cont.)

• Where to file issues:
  https://github.com/geonetwork/docker-geonetwork/issues

• Supported architectures: (more info)
  amd64

• Published image artifact details:
  repo-info repo's repos/geonetwork/ directory (history)
  (image metadata, transfer size, etc)

• Image updates:
  official-images PRs with label library/geonetwork
  official-images repo's library/geonetwork file (history)

• Source of this description:
  docs repo's geonetwork/ directory (history)

What is GeoNetwork?

GeoNetwork is a catalog application to manage spatially referenced resources. It provides powerful metadata editing and search functions as well as an interactive web map viewer.

The GeoNetwork project started out in year 2001 as a Spatial Data Catalogue System for the Food and Agriculture organisation of the United Nations (FAO), the United Nations World Food Programme (WFP) and the United Nations Environmental Programme (UNEP).

At present the project is widely used as the basis of Spatial Data Infrastructures all around the world.

GeoNetwork has been developed to connect spatial information communities and their data using a modern architecture, which is at the same time powerful and low cost, based on the principles of Free and Open Source Software (FOSS) and International and Open Standards for services and protocols (e.g.: ISO/TC211, OGC).

The project is part of the Open Source Geospatial Foundation ( OSGeo ) and can be found at GeoNetwork opensource. GeoNetwork has been developed to connect spatial information communities and their data using a modern architecture, which is at the same time powerful and low cost.

How to use this image

Start geonetwork

This command will start a debian-based container, running a Tomcat web server, with a geonetwork war deployed on the server:

$ docker run --name some-geonetwork -d geonetwork

Publish port

Geonetwork listens on port 8080. If you want to access the container at the host, you must publish this port. For instance, this, will redirect all the container traffic on port 8080, to the same port on the host:

$ docker run --name some-geonetwork -d -p 8080:8080 geonetwork

Then, if you are running docker on Linux, you may access geonetwork at http://localhost:8080/geonetwork. Otherwise, replace localhost by the address of your docker machine.

Set the data directory and H2 db file

The data directory is the location on the file system where the catalog stores much of its custom configuration and uploaded files. It is also where it stores a number of support files, used for various purposes (e.g.: Lucene index, spatial index, thumbnails). The default variant also uses a local H2 database to store the metadata catalog itself.

By default, geonetwork sets the data directory on /usr/local/tomcat/webapps/geonetwork/WEB-INF/data and H2 database file to the tomcat bin dir /usr/local/tomcat/gn.h2.db, but you may override these values by injecting environment variables into the container: - -e DATA_DIR=... (defaults to /usr/local/tomcat/webapps/geonetwork/WEB-INF/data) and -e GEONETWORK_DB_NAME=... (defaults to gn which sets up database gn.h2.db in tomcat bin dir /usr/local/tomcat). Note that setting the database location via GEONETWORK_DB_NAME only works from version 3.10.3 onwards.

Persisting data

To set the data directory to /var/lib/geonetwork/data and H2 database file to /var/lib/geonetwork/db/gn.h2.db so they both persist through restarts:

$ docker run --name some-geonetwork -d -p 8080:8080 -e DATA_DIR=/var/lib/geonetwork/data -e GEONETWORK_DB_NAME=/var/lib/geonetwork/db/gn geonetwork

If you want the data directory to live beyond restarts, or even destruction of the container, you can mount a directory from the docker engine's host into the container. - -v /host/path:/path/to/data/directory. For instance this, will mount the host directory /host/geonetwork-docker into /var/lib/geonetwork on the container:

$ docker run --name some-geonetwork -d -p 8080:8080 -e DATA_DIR=/var/lib/geonetwork/data -e GEONETWORK_DB_NAME=/var/lib/geonetwork/db/gn -v /host/geonetwork-docker:/var/lib/geonetwork geonetwork

... via docker stack deploy or docker-compose

Example stack.yml for geonetwork:

# GeoNetwork
#
# Access via "http://localhost:8080/geonetwork" (or "http://$(docker-machine ip):8080/geonetwork" if using docker-machine)
#
# Default user: admin
# Default password: admin

version: '3.1'
services:

  geonetwork:
    image: geonetwork
    restart: always
    ports:
      - 8080:8080
    environment:
      DATA_DIR: /var/lib/geonetwork_data
    volumes:
      - geonetwork:/var/lib/geonetwork_data

volumes:
  geonetwork:

Run docker stack deploy -c stack.yml geonetwork (or docker-compose -f stack.yml up), wait for it to initialize completely, and visit http://swarm-ip:8080/geonetwork, http://localhost:8080/geonetwork, or http://host-ip:8080/geonetwork (as appropriate).

Default credentials

After installation a default user with name admin and password admin is created. Use this credentials to start with. It is recommended to update the default password after installation.

Image Variants

The geonetwork images come in many flavors, each designed for a specific use case.

geonetwork:<version>

This is the defacto image. If you are unsure about what your needs are, you probably want to use this one. It is designed to be used both as a throw away container (mount your source code and start the container to start your app), as well as the base to build other images off of.

By default, an H2 database is configured and created when the application first starts. If you are interested in a database engine other than H2, please have a look at other image variants.

geonetwork:postgres

This image gives support for using PostgreSQL as database engine for geonetwork. When you start the container, a database is created, and it is populated by geonetwork, once it starts.

Please note that this image does not ship the postgres database server itself, but it gives you the option to link to a container running postgres, or to connect to a postgres instance using its ip address. If you are looking for a self-contained installation of geonetwork, including the database engine, please have a look at the default image variant.

In order to setup the connection from geonetwork, you must inject the following variables into the container: - POSTGRES_DB_USERNAME: postgres user on your database server (must have permission to create databases) - POSTGRES_DB_PASSWORD: postgres password on your database server

If your postgres instance is listening on a non-standard port, you must also set that variable: - POSTGRES_DB_PORT: postgres port on your database server (defaults to 5432)

Connecting to a postgres database

If you want to connect to a postgres server, you need to pass an extra environment variable, POSTGRES_DB_HOST, containing the address of this server.

If you want to connect to an external database server, you can use either the IP address or the DNS as POSTGRES_DB_HOST. For instance, if the server is running on mydns.net, on port 5434, the username is postgres and the password is mysecretpassword:

$ docker run --name geonetwork -d -p 8080:8080 -e POSTGRES_DB_HOST=mydns.net -e POSTGRES_DB_PORT=5434 -e POSTGRES_DB_USERNAME=postgres -e POSTGRES_DB_PASSWORD=mysecretpassword -e POSTGRES_DB_NAME=mydbname geonetwork:postgres

If are want to run postgres on a container, you can use the container name as POSTGRES_DB_HOST: just make sure that containers can discover each other, by running them in the same user-defined network. For instance, you can create a bridge network:

$ docker network create --driver bridge mynet

Then if you want to run the official image of postgres, using some-postgres as container name, you could launch it like this:

$ docker run --name some-postgres --network=mynet -d postgres

And then you could launch geonetwork, making sure you join the same network, and setting the required environment variables, including the POSTGRES_DB_HOST:

$ docker run --name geonetwork -d -p 8080:8080 --network=mynet -e POSTGRES_DB_HOST=some-postgres -e POSTGRES_DB_PORT=5432 -e POSTGRES_DB_USERNAME=postgres -e POSTGRES_DB_PASSWORD=mysecretpassword  -e POSTGRES_DB_NAME=mydbname geonetwork:postgres

Configuration environment variables

These are some environments variables that can be set to configure the database connection:

• POSTGRES_DB_HOST: database host name.
• POSTGRES_DB_PORT: port where database server is listening (by default 5432).
• POSTGRES_DB_NAME: name of the database. If it doesn't exist the container will try to create it.
• POSTGRES_DB_USERNAME: username.
• POSTGRES_DB_PASSWORD: password.

License

View license information for the software contained in this image.

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).

Some additional license information which was able to be auto-detected might be found in the repo-info repository's geonetwork/ directory.

As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.