Getting Started
Installation

Installation

SchemaHero is distributed as a single binary. Choose your platform:

macOS

Homebrew (recommended):

brew tap schemahero/tap
brew install schemahero

Or in one command:

brew install schemahero/tap/schemahero

Binary download:

curl -sSL https://github.com/schemahero/schemahero/releases/latest/download/schemahero_darwin_amd64.tar.gz | tar xz
sudo mv schemahero /usr/local/bin/

For Apple Silicon (M1/M2/M3):

curl -sSL https://github.com/schemahero/schemahero/releases/latest/download/schemahero_darwin_arm64.tar.gz | tar xz
sudo mv schemahero /usr/local/bin/

Linux

Homebrew (Linuxbrew):

brew tap schemahero/tap
brew install schemahero

amd64:

curl -sSL https://github.com/schemahero/schemahero/releases/latest/download/schemahero_linux_amd64.tar.gz | tar xz
sudo mv schemahero /usr/local/bin/

arm64:

curl -sSL https://github.com/schemahero/schemahero/releases/latest/download/schemahero_linux_arm64.tar.gz | tar xz
sudo mv schemahero /usr/local/bin/

Windows

Download the latest release from GitHub Releases (opens in a new tab) and add it to your PATH.

Docker

SchemaHero is also available as a Docker image:

docker run --rm schemahero/schemahero:latest version

Useful for CI/CD pipelines where you don't want to install the binary.

Verify Installation

schemahero version

You should see output like:

SchemaHero 0.24.0

Kubernetes (Optional)

If you want to use SchemaHero as a Kubernetes operator, see the Kubernetes Operator Guide.

The CLI works standalone without Kubernetes. The operator is optional and provides features like migration approval workflows within a cluster.