Installation | geolith Builder docs

Prerequisites

Rust toolchain — version 1.99 or later (rustup.rs)
Protocol Buffers compiler — protoc (installation guide)
Machine — for a geocoding (.glx) build of a country: 8 GB of memory and an SSD with about 35 GB free. See Geocoding system requirements.

Verify your environment:

rustc --version
# rustc 1.99.0 or later

protoc --version
# libprotoc 28.0 or later

Install directly from crates.io:

cargo install geolith

This compiles and installs the geolith binary to ~/.cargo/bin/. Make sure this directory is in your PATH.

The source repository is private. Write to contact@geolith.app for access, then build in release mode from the checkout:

cd geolith
cargo build --release

The compiled binary is at target/release/geolith. You can copy it to a directory in your PATH:

cp target/release/geolith ~/.cargo/bin/

Info

Always use --release for production builds. Debug builds are significantly slower for tile generation and should only be used during development.

geolith --version
geolith --help