mapserver/doc/install.md

# Mapserver installation

**Please make a backup of your world in case something goes wrong**

## Simple installation

* Download the binary from the [releases](https://github.com/minetest-tools/mapserver/releases) for your architecture and platform
* Drop the binary into your world folder (the one with the `world.mt` and `map.sqlite` files)
* Start the mapserver via command-line: `./mapserver` or `./mapserver.exe`
* Point your browser to `http://127.0.0.1:8080`

For additional infos (lag,time,players => active mode) on the mapserver interface you should install the [mapserver-mod](mod.md)

## Docker image

* Docker-hub: https://hub.docker.com/repository/docker/minetesttools/mapserver

Simple docker run example to run in the world-directory:

```
docker run --rm --it -p 8080:8080 -v $(pwd):/minetest -w /minetest minetesttools/mapserver
```

## Docker compose

Examplary `docker-compose` config:

```yml
services:
  mapserver:
   image: minetesttools/mapserver
   restart: always
   networks:
    - default
   depends_on:
    - "postgres"
   volumes:
    - "./data/minetest/world:/minetest"
   working_dir: "/minetest"
```

* See also: https://github.com/pandorabox-io/pandorabox.io/blob/master/docker-compose.yml

## Performance / Scalability

For small to medium setups the default values should suffice.
If you have a bigger map (say: above 10 GB) you should configure the mapserver accordingly:

* See [Mapobject-Database](./mapobjectdb.md) for a scalable mapserver database