Lib.rs

EarthWyrm is an open-source map server developed for the Minnesota Department of Transportation (MnDOT). It can serve GIS data from OpenStreetMap or other sources.

Features:

• Layers configurable by zoom level
• Web Mercator projection (EPSG:3857)
• Vector tiles in MVT format, with Z/X/Y.mvt naming convention
• Quick setup in under 10 minutes

👉 Install using cargo (tested on Fedora Linux):

cargo install earthwyrm-bin
sudo bash
«enter password at prompt»
install ~/.cargo/bin/earthwyrm /usr/local/bin/
useradd --system -m -b /var/local earthwyrm
sudo -i -u earthwyrm /usr/local/bin/earthwyrm init

This file tree will be created:

/var/local/earthwyrm/
├── earthwyrm.muon
├── earthwyrm.service
├── loam/
└── osm/

👉 Edit the configuration file at /var/local/earthwyrm/earthwyrm.muon. It contains examples and instructions.

👉 Download an OpenStreetMap extract of your region in PBF format into the /var/local/earthwyrm/osm/ directory. For example, files such as minnesota-latest.osm.pbf are provided daily from Geofabrik.

👉 Dig the configured layers into .loam cache files:

sudo -i -u earthwyrm /usr/local/bin/earthwyrm dig

NOTE: This step may take a while, depending on the region size.

👉 Configure systemd service

cp /var/local/earthwyrm/earthwyrm.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable earthwyrm
systemctl start earthwyrm

👉 Test

From the server host, browse to 127.0.0.1:3030