tethysplatform/geoserver repository overview

⁠GeoServer Docker

This Docker provides a GeoServer instance. The Dockerfile and context can be found in this repository:

https://github.com/tethysplatform/tethys_docker

NOTE: There are several Dockerfiles in this repository. The GeoServer Dockerfile is in the geoserver directory.

⁠Installation

There are two ways to install this Docker:

1. Pull image from Docker repository:

    $ sudo docker pull tethysplatform/geoserver
   

   Copy

2. Build from source:

    $ git clone https://github.com/tethysplatform/tethys_docker.git
    $ cd tethys_docker/geoserver
    $ sudo docker build -t tethysplatform/geoserver .
   

   Copy

⁠Run Container

Start the GeoServer Docker container as follows:

$ sudo docker run -d -p 8080:8080 --name geoserver tethysplatform/geoserver

Browse to http://localhost:8080/geoserver/web/⁠ to see your running geoserver.

NOTE: The above command will map the Docker's port 8080 to the host 8080. If your port 8080 is not available, modify the command to use a port that works for you. See Docker Documentation⁠ for more information about how to use Docker containers.

⁠Environment Variables

• ENABLED_NODES: Number of GeoServer nodes to start up to 4.

• REST_NODES: Number of the enabled GeoServer nodes to have support the REST interface. We recommend setting this to 1.

• MAX_MEMORY: Maximum memory to allow each node to allocate in MB. Set this based on the memory available on the machine you are installing GeoServer on. Caution: the total memory will be MAX_MEMORY * ENABLED_NODES.

• MIN_MEMORY: Minimum memory to allow each node to allocate initially in MB. Set this based on the memory available on the machine you are installing GeoServer on. Caution: the GeoServer will allocate MIN_MEMORY * ENABLED_NODES when it starts.

• NUM_CORES: The number of cores you want GeoServer to use. This should be less than or equal to the number of cores on the machine.

• MAX_TIMEOUT: Maximum time in seconds to wait before returning timeout. Defaults to 60 seconds.

  sudo docker run -d -p 80:8080 --restart=always --name geoserver -e ENABLED_NODES=4 -e REST_NODES=1 -e MAX_MEMORY=1024 -e MIN_MEMORY=512 -e NUM_CORES=4 -e MAX_TIMEOUT=60 tethysplatform/geoserver