Installation via Docker

MapProxy does have its own official docker images. These are currently hosted on the GitHub container registry and can be found here:

• mapproxy/mapproxy

Currently we have 3 different images for every release, named e.g.

• ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0

• ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0-dev

• ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0-nginx

The first one comes with everything installed, but no HTTP WebServer running. You can use it to implement your custom setup.

The second image, ending with -dev, starts the integrated webserver mapproxy provides through mapproxy-util serve-develop.

The third image, ending with -nginx, comes bundled with a preconfigured nginx HTTP Server, that lets you use MapProxy instantly in a production environment.

See the quickstart section below for a configuration / example on how to use those images.

There are also several unofficial Docker images available on Docker Hub that provide ready-to-use containers for MapProxy.

The community has very good experiences with the following ones:

• https://hub.docker.com/repository/docker/justb4/mapproxy/general (github just4b)

• https://hub.docker.com/r/kartoza/mapproxy (github kartoza)

There are also images available that already include binaries for MapServer or Mapnik:

• justb4/docker-mapproxy-mapserver

• justb4/docker-mapproxy-mapserver-mapnik

Quickstart

Depending on your needs, pull the desired image (see description above):

docker pull ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0

or:

docker pull ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0-dev

or:

docker pull ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0-nginx

Create a directory (e.g. mapproxyconfig) for your configuration files. Put your configs into that folder. If you do not supply config files (seed.yaml and mapproxy.yaml) the image will create them for you.

To start the docker container with a mount on your config folder, use the command matching your image.

Running the plain image without starting a webserver

docker run --rm --name "mapproxy" -t -v `pwd`/mapproxyconfig:/mapproxy/config ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0

Afterwards, the MapProxy instance is idling and you can connect with the container via e.g.

docker exec -it mapproxy bash

Running the dev image

docker run --rm --name "mapproxy" -p 8080:8080 -t -v `pwd`/mapproxyconfig:/mapproxy/config ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0-dev

Afterwards, the MapProxy instance is running on http://localhost:8080/demo/

Running the nginx image

docker run --rm --name "mapproxy" -p 80:80 -t -v `pwd`/mapproxyconfig:/mapproxy/config ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0-nginx

Afterwards, the MapProxy instance is running on http://localhost/mapproxy/demo/

Build your own image

The Dockerfiles contain a setup that will build the current state of the repository in a builder image.

For the plain image without starting a webserver

docker build --target base -t ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0 .

For the dev image

docker build --target development -t ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0-dev .

For the nginx image

docker build --target nginx -t ghcr.io/mapproxy/mapproxy/mapproxy:1.16.0-nginx .