forked from MTSR/mapserver
51 lines
1.5 KiB
Markdown
51 lines
1.5 KiB
Markdown
|
|
# 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-mapserver/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/minetestmapserver/mapserver
|
|
|
|
Simple docker run example to run in the world-directory:
|
|
|
|
```
|
|
docker run --rm --it -p 8080:8080 -v $(pwd):/minetest -w /minetest minetestmapserver/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
|