Installation

runok supports macOS and Linux. Choose the installation method that suits your environment.

Homebrew (recommended)

brew install fohte/tap/runok

This installs runok from the fohte/homebrew-tap repository.

From source (cargo)

If you have a Rust toolchain installed, you can install runok directly from the Git repository:

cargo install --git https://github.com/fohte/runok.git

This builds and installs the runok binary into your Cargo bin directory (typically ~/.cargo/bin/).

From GitHub Releases

Pre-built binaries are available on the GitHub Releases page.

macOS (Apple Silicon)

curl -fsSL https://github.com/fohte/runok/releases/latest/download/runok-aarch64-apple-darwin.tar.gz | tar xz
sudo mv runok /usr/local/bin/

Linux (x86_64)

curl -fsSL https://github.com/fohte/runok/releases/latest/download/runok-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv runok /usr/local/bin/

Linux (aarch64)

curl -fsSL https://github.com/fohte/runok/releases/latest/download/runok-aarch64-unknown-linux-gnu.tar.gz | tar xz
sudo mv runok /usr/local/bin/

Verify installation

After installation, verify that runok is available:

runok --version

Next steps

Proceed to the Quick Start to create your first runok.yml configuration.