Prerequisites
- Rust toolchain — version 1.85 or later (rustup.rs)
- Protocol Buffers compiler —
protoc(installation guide)
Verify your environment:
rustc --version
# rustc 1.85.0 or later
protoc --version
# libprotoc 28.0 or later
From Source
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.
Build from Git
Clone the repository and build in release mode:
git clone https://github.com/geolith/geolith.git
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/
Always use --release for production builds. Debug builds are significantly slower for tile generation and should only be used during development.
Verify Installation
geolith --version
geolith --help