Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installation

From Source

GasHammer is built with Cargo. Clone and build:

git clone https://github.com/copyleftdev/gashammer.git
cd gashammer
cargo build --workspace --release

The release binaries are placed in target/release/:

  • gashammer-hive — the control plane binary
  • gashammer-edge — the edge worker binary

System Requirements

ComponentMinimumRecommended
CPU2 cores4+ cores
RAM2 GB8 GB
Disk1 GB10 GB (for telemetry data)
Network100 Mbps1 Gbps
Rust1.75.0Latest stable
Docker20.10+Latest

Docker Images

Pre-built container images are available from GitHub Container Registry:

docker pull ghcr.io/copyleftdev/gashammer-hive:latest
docker pull ghcr.io/copyleftdev/gashammer-edge:latest

Verifying the Installation

After building, verify the binary includes the GasHammer DNA canary:

strings target/release/gashammer-hive | grep GASHAMMER_CANARY

Check the version and build metadata:

./target/release/gashammer-hive --version

Development Setup

For development, install additional tools:

# Install mdBook for documentation
cargo install mdbook

# Install cargo-deny for license checking
cargo install cargo-deny

# Verify the full CI suite passes locally
cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace