Skip to content

Installation

Rocky is a single static binary. There is no separate runtime to install, and no package manager to configure. Pick your platform below.

Terminal window
curl -fsSL https://raw.githubusercontent.com/rocky-data/rocky/main/engine/install.sh | bash

The script installs to ~/.local/bin/rocky and verifies the checksums. Make sure ~/.local/bin is on your PATH:

Terminal window
export PATH="$HOME/.local/bin:$PATH"

The install script takes these settings, both optional.

Install to a custom directory:

Terminal window
curl -fsSL https://raw.githubusercontent.com/rocky-data/rocky/main/engine/install.sh \
| ROCKY_INSTALL_DIR=/usr/local/bin bash

Pin a specific version:

Terminal window
curl -fsSL https://raw.githubusercontent.com/rocky-data/rocky/main/engine/install.sh | bash -s -- <version>

Prefer to download the archive yourself? Take it from the releases page:

Platform Archive
macOS (Apple Silicon) rocky-aarch64-apple-darwin.tar.gz
macOS (Intel) rocky-x86_64-apple-darwin.tar.gz
Linux x86_64 rocky-x86_64-unknown-linux-gnu.tar.gz
Linux ARM64 rocky-aarch64-unknown-linux-gnu.tar.gz
Windows x86_64 rocky-x86_64-pc-windows-msvc.zip

Requires Rust 1.88+ (edition 2024).

Terminal window
git clone https://github.com/rocky-data/rocky.git
cd rocky/engine
cargo build --release
# binary at target/release/rocky

Confirm the binary is on your PATH and prints a version:

Terminal window
rocky --version

That is the install done. Next, run the Quickstart. No warehouse handy? The Playground runs the same flow on a local DuckDB file, with no credentials needed.