https://github.com/carletes/docker-mapserver

A Docker image for a FastCGI MapServer instance
https://github.com/carletes/docker-mapserver

docker fastcgi mapserver

Last synced: 12 days ago
JSON representation

A Docker image for a FastCGI MapServer instance

• Host: GitHub
• URL: https://github.com/carletes/docker-mapserver
• Owner: carletes
• Created: 2017-05-05T14:49:41.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2017-05-06T15:58:50.000Z (almost 9 years ago)
• Last Synced: 2025-10-19T02:34:55.924Z (6 months ago)
• Topics: docker, fastcgi, mapserver
• Language: Shell
• Size: 14.6 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# A FastCGI MapServer instance

[![](https://images.microbadger.com/badges/version/carletes/mapserver.svg)](https://microbadger.com/images/carletes/mapserver "Get your own image badge on microbadger.com")

[![](https://images.microbadger.com/badges/image/carletes/mapserver.svg)](https://microbadger.com/images/carletes/mapserver "Get your own image badge on microbadger.com")

[![](https://images.microbadger.com/badges/commit/carletes/mapserver.svg)](https://microbadger.com/images/carletes/mapserver "Get your own commit badge on microbadger.com")

This image implements a [MapServer](http://mapserver.org/) instance accepting [FastCGI](https://en.wikipedia.org/wiki/FastCGI) connections.

It listens by default on port 9001, and expects MapServer map files and related data to be available in a volume mounted on `/data`.

## Usage

The following will start a MapServer instance listening on port 9001 for FastCGI connections, and serving MapServer data from the directory `/some/mapserver/data`:

    $ docker run \

	    --volume=/some/mapserver/data:/data:ro \

		carletes/mapserver

If you want to listen on a different port, use the `FCGI_LISTEN_PORT` environment variable:

    $ docker run \

	    --volume=/some/mapserver/data:/data:ro \

		--env=FCGI_LISTEN_PORT=9022 \

		carletes/mapserver

You will need a web server to expose MapServer to your clients via HTTP. The GitHub repository [carletes/docker-mapserver-example](https://github.com/carletes/docker-mapserver-example) shows a way of doing it.

## Configurable parameters

The following environment variables can set in order to tweak the behaviour of MapServer:

| Variable              | Description                                 | Default value |

|-----------------------|---------------------------------------------|---------------|

| `FCGI_LISTEN_ADDRESS` | Listening address for FastCGI requests      | 0.0.0.0       |

| `FCGI_LISTEN_PORT`    | Listening port for FastCGI requests         | 9001          |

| `FCGI_NPROC`          | Nimber of FastCGI child processes to spawn  | 1             |

| `FCGI_BACKLOG`        | TCP connection backlog for FastCGI requests | 1024          |

| `FCGI_UID`            | Unix UID of FastCGI process                 | `mapserver`   |

| `FCGI_GID`            | Unix GID of FastCGI process                 | `mapserver`   |

All [MapServer environment variables](http://mapserver.org/environment_variables.html) may be specified as well. This images runs with the following non-default MapServer environment variables:

| MapServer variable | Value used in this image         |

|--------------------|----------------------------------|

| `MS_ERRORFILE`     | `stderr`                         |