Installation Guide
Learn how to build and configure the GhostMesh background daemon on mobile and desktop platforms.
1. Prerequisites
To compile and run the GhostMesh daemon, your machine needs to support low-power wireless interfaces. Make sure you have the following installed:
- Rust Compiler (MSRV 1.75+)
- LLVM / Clang compiler toolchain
- Bluetooth development headers (`libbluetooth-dev` on Linux)
2. Precompiled Binaries
For quick setups, pre-compiled daemon binaries are released via GPG-signed distributions. You can download and initialize the daemon directly:
# Download the latest daemon binary for Linux amd64
curl -sSL https://releases.ghostmesh.org/v1.2/ghostmesh-daemon-linux-amd64 -o ghostmesh-d
# Verify GPG signature
gpg --verify ghostmesh-d.sig ghostmesh-d
# Make executable and run
chmod +x ghostmesh-d
./ghostmesh-d --init
curl -sSL https://releases.ghostmesh.org/v1.2/ghostmesh-daemon-linux-amd64 -o ghostmesh-d
# Verify GPG signature
gpg --verify ghostmesh-d.sig ghostmesh-d
# Make executable and run
chmod +x ghostmesh-d
./ghostmesh-d --init
3. Compiling From Source
We highly recommend compiling from source to verify that no malicious code compromises your binary compilation.
# Clone main workspace
git clone https://github.com/ghostmesh/ghostmesh-protocol.git
cd ghostmesh-protocol/daemon
# Build release target optimized for low memory usage
cargo build --release --features low_mem
# Run test suites
cargo test --workspace
git clone https://github.com/ghostmesh/ghostmesh-protocol.git
cd ghostmesh-protocol/daemon
# Build release target optimized for low memory usage
cargo build --release --features low_mem
# Run test suites
cargo test --workspace
4. Verifying Installation
Ensure the daemon can successfully hook into your device's BLE and Wi-Fi transmitters by verifying local loopbacks:
./target/release/ghostmesh-d --verify-transmitters
✓ BLE transmitter verified: OK
✓ Wi-Fi Direct interface verified: OK