Installing Reis

Reis ships as a single self-contained binary. No PHP runtime, no interpreters, and no package managers are required — just download and run.

Supported platforms

Homebrew (macOS and Linux)

The easiest way to install on macOS or Linux with Homebrew:

brew tap bahriya/tap https://1x.ax/bahriya/library/homebrew-tap.git
brew install reis

To update:

brew upgrade reis

Shell installer

The shell installer detects your OS and architecture automatically:

curl -sSL https://get.bahriya.cloud/reis | bash

This downloads the correct binary and installs it to /usr/local/bin. If the directory is not writable, the installer uses sudo automatically.

Installer options

# Install a specific version
curl -sSL https://get.bahriya.cloud/reis | bash -s -- --version 0.1.10
 
# Install to a custom directory
curl -sSL https://get.bahriya.cloud/reis | bash -s -- --install-dir /opt/bin

You can also use environment variables:

REIS_VERSION=0.1.10 REIS_INSTALL_DIR=/opt/bin curl -sSL https://get.bahriya.cloud/reis | bash

Direct download

Download the binary for your platform from the releases page:

# macOS Apple Silicon
curl -fsSL https://get.bahriya.cloud/reis/releases/latest/reis-darwin-arm64 -o reis
 
# macOS Intel
curl -fsSL https://get.bahriya.cloud/reis/releases/latest/reis-darwin-x86_64 -o reis
 
# Linux x86_64
curl -fsSL https://get.bahriya.cloud/reis/releases/latest/reis-linux-x86_64 -o reis
 
# Linux ARM64
curl -fsSL https://get.bahriya.cloud/reis/releases/latest/reis-linux-aarch64 -o reis

Then make it executable and move it to your PATH:

chmod +x reis
sudo mv reis /usr/local/bin/

Docker

Reis is published as a public multi-arch Docker image at 1x.ax/bahriya/library/reis. It supports both linux/amd64 and linux/arm64, has reis set as the entrypoint, and ships with git and ca-certificates pre-installed — useful for CI/CD pipelines that clone repositories and call the API in the same step.

Tags

Pull

docker pull 1x.ax/bahriya/library/reis:latest

Run

The entrypoint is reis, so any arguments you pass become Reis subcommands and flags:

docker run --rm 1x.ax/bahriya/library/reis:latest version

For commands that need authentication, pass your PAT via REIS_TOKEN:

docker run --rm \
  -e REIS_TOKEN \
  1x.ax/bahriya/library/reis:latest container:list --project my-project

If you prefer the config-file flow, mount your local ~/.reis directory:

docker run --rm \
  -v "$HOME/.reis:/root/.reis" \
  1x.ax/bahriya/library/reis:latest auth:status

To apply YAML files from the current directory:

docker run --rm \
  -e REIS_TOKEN \
  -v "$PWD:/work" -w /work \
  1x.ax/bahriya/library/reis:latest apply -f infrastructure.yml

Pinning a version in CI

Always pin a specific tag in CI/CD pipelines so an upstream Reis release cannot change your build:

docker run --rm -e REIS_TOKEN \
  1x.ax/bahriya/library/reis:0.1.10 apply -f infrastructure.yml

See the CI/CD guide for full pipeline examples.

Verifying the installation

reis version

This prints the Reis version, PHP version (embedded), OS, architecture, and config file path.

Updating

• Homebrew: brew upgrade reis
• Shell installer: Re-run the installer — it overwrites the existing binary
• Direct download: Download the new version and replace the binary

Uninstalling

Shell uninstaller

The shell uninstaller removes the binary and the ~/.reis config directory:

curl -sSL https://get.bahriya.cloud/reis/uninstall | bash

To keep your credentials and config:

curl -sSL https://get.bahriya.cloud/reis/uninstall | bash -s -- --keep-config

If you installed to a custom directory:

curl -sSL https://get.bahriya.cloud/reis/uninstall | bash -s -- --install-dir /opt/bin

Homebrew

brew uninstall reis

Note: Homebrew does not remove ~/.reis. Delete it manually if you want to clean up credentials:

rm -rf ~/.reis

Manual

sudo rm /usr/local/bin/reis
rm -rf ~/.reis