Install ContainerHive

ContainerHive supports a variety of platforms.

Homebrew

brew tap ContainerHive/ContainerHive
brew install ContainerHive

Containerized

If you prefer to use containerized workflows, use the provided OCI image.

docker run --rm -it -v $PWD:/workspace containerhive/containerhive

Pre-commit

ContainerHive provides pre-commit hooks for generating CI pipelines, verifying project structure, and running arbitrary ContainerHive commands.

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/ContainerHive/pre-commit
    rev: main # use tag or commit hash for your projects
    hooks:
      - id: template
        args: [ci, --provider, github, --output, .github/workflows/main.yml]

See the pre-commit usage guide for all available hooks and configuration options.

Manual

Linux (64-bit)

curl -LO https://github.com/ContainerHive/ContainerHive/releases/download/$(curl -Lso /dev/null -w %{url_effective} https://github.com/ContainerHive/ContainerHive/releases/latest | grep -o '[^/]*$')/linux-amd64.tar.zst && \
tar --zstd -xf linux-amd64.tar.zst ch && \
chmod +x ch && \
sudo mv ch /usr/local/bin/ch

Linux (ARM 64-bit)

curl -LO https://github.com/ContainerHive/ContainerHive/releases/download/$(curl -Lso /dev/null -w %{url_effective} https://github.com/ContainerHive/ContainerHive/releases/latest | grep -o '[^/]*$')/linux-arm64.tar.zst && \
tar --zstd -xf linux-arm64.tar.zst ch && \
chmod +x ch && \
sudo mv ch /usr/local/bin/ch

Darwin (Intel)

curl -LO https://github.com/ContainerHive/ContainerHive/releases/download/$(curl -Lso /dev/null -w %{url_effective} https://github.com/ContainerHive/ContainerHive/releases/latest | grep -o '[^/]*$')/darwin-amd64.tar.zst && \
tar --zstd -xf darwin-amd64.tar.zst ch && \
chmod +x ch && \
sudo mv ch /usr/local/bin/ch

Darwin (Apple Silicon)

curl -LO https://github.com/ContainerHive/ContainerHive/releases/download/$(curl -Lso /dev/null -w %{url_effective} https://github.com/ContainerHive/ContainerHive/releases/latest | grep -o '[^/]*$')/darwin-arm64.tar.zst && \
tar --zstd -xf darwin-arm64.tar.zst ch && \
chmod +x ch && \
sudo mv ch /usr/local/bin/ch

Where to find the latest release

Binaries

Binaries for all platforms can be found on the latest release page.

Docker

For the Docker image, check Docker Hub.