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

hoike produces two binaries:

BinarySizePurpose
hoike~8 MBOCSP responder, signer, config checker
ahu~1 MBBundle 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

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.