Installation
hoike produces two binaries:
| Binary | Size | Purpose |
|---|---|---|
hoike | ~8 MB | OCSP responder, signer, config checker |
ahu | ~1 MB | Bundle inspection, verification, diffing, patching |
Prerequisites
- Rust 1.85+ (install via rustup)
- A C compiler, CMake, and pkg-config (AWS-LC is used for RSA CRL verification even in builds without TLS)
- Debian/Ubuntu:
build-essential cmake pkg-config - Fedora/RHEL:
gcc cmake pkgconf-pkg-config - macOS: Xcode CLT plus
brew install cmake pkg-config
- Debian/Ubuntu:
Verify your Rust version:
rustc --version
# rustc 1.85.0 (... 2025-...)
Build from source
Clone the repository and build in release mode:
git clone https://github.com/czinda/hoike.git
cd hoike
cargo build --release
The binaries are placed in target/release/:
ls -lh target/release/hoike target/release/ahu
Copy them to a directory on your PATH:
sudo install -m 755 target/release/hoike /usr/local/bin/
sudo install -m 755 target/release/ahu /usr/local/bin/
Verify the installation (a --version flag is not implemented yet, so confirm the binaries run and print help):
hoike --help
ahu --help
Container build
A Containerfile is provided for building a minimal container image:
podman build -t hoike .
Or with Docker:
docker build -t hoike .
Run the container with your configuration and bundle directory mounted:
podman run -d \
--name hoike \
-p 2560:2560 \
-v /etc/hoike/hoike.toml:/etc/hoike/hoike.toml:ro \
-v /var/lib/hoike/bundles:/var/lib/hoike/bundles:ro \
hoike serve --config /etc/hoike/hoike.toml
Build individual crates
If you only need the bundle library (for example, to integrate ahu into another tool):
cargo build --release -p ahu
Or just the CLI without gossip support:
cargo build --release -p hoike-cli --no-default-features
Next steps
With hoike and ahu installed, proceed to Your First Bundle to create a signed ahu bundle from a test CA.