Building from Source
Clone and build
git clone https://github.com/omnelabs/omne-blockchain.git
cd omne-blockchain
cargo build --releaseThe binary lands at target/release/omne-node. Optionally copy it to your PATH:
cp target/release/omne-node ~/.local/bin/Verify the build
omne-node --versionSystem dependencies
macOS
brew install pkg-config openssl cmakeUbuntu / Debian
sudo apt-get update
sudo apt-get install -y pkg-config libssl-dev clang cmake build-essentialFedora / RHEL
sudo dnf install pkg-config openssl-devel clang cmake gccRust toolchain
The project pins nightly-2026-02-10 to avoid internal compiler errors with newer nightlies:
rustup toolchain install nightly-2026-02-10
rustup default nightly-2026-02-10Build flags
| Flag | Effect |
|---|---|
--release | Optimised build (required for production) |
--bin omne-node | Build only the node binary (faster than building all targets) |
For development iteration:
cargo build --bin omne-node
# Debug build — faster to compile, slower to runRunning tests
cargo test -p omne-blockchainThis runs the full test suite (~500+ tests). For a focused subset:
cargo test -p omne-blockchain -- --test-threads=1 test_name_pattern