# Install container-canary with Homebrew, dnf

Test and validate container requirements against versioned manifests. Version 0.5.0 via Homebrew; verified 2026-05-11.

## Install

```sh
sudo av install brew:container-canary
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install container-canary
```

  Evidence: local Homebrew formula metadata

### Linux

- dnf (92%):

```sh
sudo dnf install dummy-package-canary
```

  Evidence: Fedora Rawhide package metadata: dummy-package-canary from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

## Package facts

- **Package key:** brew:container-canary
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/container-canary>
- **Version:** 0.5.0
- **Source summary:** Test and validate container requirements against versioned manifests
- **Homepage:** <https://github.com/NVIDIA/container-canary>
- **Repository:** <https://github.com/NVIDIA/container-canary>
- **Upstream docs:** <https://github.com/NVIDIA/container-canary#readme>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/NVIDIA/container-canary/archive/refs/tags/v0.5.0.tar.gz>
- **Last updated:** 2026-05-11T17:43:30-04:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- canary (cli)
- canary (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.5.0
- Package-manager updated: 2026-05-11
- Local data: ok
- Upstream repository: https://github.com/NVIDIA/container-canary
- Upstream latest detected: v0.5.0 (current)
## Project history and usage

Container Canary is an NVIDIA container validation CLI for checking image requirements against versioned manifests. Its history is tied to CI-oriented validation of bring-your-own-container platforms rather than to a broad runtime or orchestration layer.

### Project history

The project presents itself as a tool for recording platform requirements as a manifest and validating container images against that manifest. Official releases began with v0.1.0 in March 2022, with later 0.x releases continuing through 2025.

### Adoption history

Official documentation illustrates the tool with a Kubeflow Notebooks-style requirements manifest, but it does not publish a broad adopter list. The safest reading is that Container Canary serves teams that need repeatable image conformance checks for managed compute or notebook platforms.

### How it is used

Users run the `canary` command against a YAML validator file and a target container image. The checks borrow concepts from Kubernetes probes, including exec, HTTP, and TCP socket tests, so it fits naturally into CI pipelines already using container and Kubernetes vocabulary.

### Why package nerds care

For package managers, Container Canary is a small Go CLI whose value is in making container-image policy testable and versioned. It is useful when a package ecosystem needs to validate that images contain expected users, ports, services, or files before publishing or deploying them.

### Timeline

- 2022: v0.1.0 release published.
- 2024: v0.3.0 and v0.4.0 releases published.
- 2025: v0.5.0 release published.

### Related projects

- The README connects Container Canary concepts to Kubernetes probes and uses Kubeflow Notebooks requirements as its main worked example.

### Sources

- <https://github.com/NVIDIA/container-canary#readme>
- <https://github.com/NVIDIA/container-canary/releases/tag/v0.1.0>
- <https://github.com/NVIDIA/container-canary/releases/tag/v0.5.0>


## Security Notes

infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- infrastructure mutation or orchestration signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** container-canary
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- dnf - dummy-package-canary - 2-25.fc44: installed executable or alias match | Fedora Rawhide package metadata: dummy-package-canary from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Dummy package to exercise the packaging stack


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [colima](https://www.automicvault.com/pkg/brew/colima/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, docker, kubernetes.
- [container-structure-test](https://www.automicvault.com/pkg/brew/container-structure-test/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, testing, validation.
- [dcp](https://www.automicvault.com/pkg/brew/dcp/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, docker, kubernetes.
- [containerd](https://www.automicvault.com/pkg/brew/containerd/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, kubernetes.
- [dtop](https://www.automicvault.com/pkg/brew/dtop/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, docker.
- [kbld](https://www.automicvault.com/pkg/brew/kbld/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, kubernetes.
- [ko](https://www.automicvault.com/pkg/brew/ko/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, kubernetes.
- [mintoolkit](https://www.automicvault.com/pkg/brew/mintoolkit/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, docker.
- [container-compose](https://www.automicvault.com/pkg/brew/container-compose/) - Package names and metadata indicate a similar tool family. Shared terms: cli, cloud, cloud-infrastructure, container, containers.

## Combined YAML source

View the package source record on GitHub. [combined/container-canary.yml](https://github.com/automic-vault/db/blob/main/combined/container-canary.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
