3 unstable releases

Uses new Rust 2024

0.12.1 Apr 16, 2026
0.12.0 Apr 9, 2026
0.11.2 Mar 7, 2026

#289 in Geospatial

MIT/Apache

80KB
2K SLoC

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

Map data is cached as R-Trees in a rosewood file for each layer. They contain point, linestring or polygon features, with associated tags.

Features:

  • Layers configurable by zoom level
  • Web Mercator projection (EPSG:3857)
  • ZXY tile naming scheme
  • Tiles in Wyrm or MVT format
  • Quick setup in under 10 minutes

👉 Install using cargo (tested on Fedora Linux):

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

This file tree will be created:

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

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

👉 Download an OpenStreetMap extract of your region in PBF format into the /var/local/wyrmcast/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 wyrmcast /usr/local/bin/wyrmcast dig

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

👉 Configure systemd service

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

👉 Test

From the server host, browse to 127.0.0.1:3030

Dependencies

~12–18MB
~243K SLoC