# Install dockcheck with Homebrew

CLI tool to automate docker image updates. Version 0.7.8 via Homebrew; verified 2026-06-15.

## Install

```sh
sudo av install brew:dockcheck
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install dockcheck
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:dockcheck
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/dockcheck>
- **Version:** 0.7.8
- **Source summary:** CLI tool to automate docker image updates
- **Homepage:** <https://mag37.org>
- **Repository:** <https://github.com/mag37/dockcheck>
- **Upstream docs:** <https://github.com/mag37/dockcheck#readme>
- **License:** GPL-3.0-only
- **Source archive:** <https://github.com/mag37/dockcheck/archive/refs/tags/v0.7.8.tar.gz>
- **Last updated:** 2026-06-15T10:20:15-04:00
- **Generated:** 2026-07-09T07:20:21+00:00

## Executables

- dockcheck (cli)
- dockcheck (alias)

## Dependencies

- regclient

## Uses from macOS

- jq

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-09
- Package-manager version: 0.7.8
- Package-manager updated: 2026-06-15
- Local data: ok
- Upstream repository: https://github.com/mag37/dockcheck
- Upstream latest detected: v0.7.8 (current)
## Project history and usage

Dockcheck is a Bash CLI for checking and optionally applying Docker image updates. Its README frames the tool around selective updates, include and exclude lists, image backups, labels, notifications, pruning, and Compose-aware container recreation.

### Project history

The maintainer's project writeup traces the idea to late 2022, when the original goal was to determine whether container images had updates without pulling every image first. The implementation settled on comparing local and remote image digests with help from regclient/regctl, turning a home-server maintenance annoyance into a reusable script.

### Adoption history

Dockcheck's adoption is mostly self-hosting and homelab oriented: it is packaged for Homebrew in this batch, but the upstream README still documents direct script installation into a PATH directory and cron-style unattended checks. The README also points Podman users to the podcheck fork, which is a useful signal that its audience overlaps with container tinkerers who manage small fleets outside a full orchestration platform.

### How it is used

Common usage is to scan running or stopped containers for newer images, choose which containers to update, pull the selected images, recreate containers or Compose stacks, and optionally prune dangling images afterward. Configuration lives in dockcheck.config beside the script or under ~/.config, and notifications are driven by shell templates plus channel-specific environment variables.

### Why package nerds care

Dockcheck is package-nerd interesting because it sits between heavy automated updaters and manual docker compose pull loops. It is a small shell tool built around registry digests, regctl, jq, and Compose conventions, so packaging it gives users a reproducible way to add conservative image-update checks to cron jobs and home servers.

### Timeline

- 2022: Maintainer describes the original idea forming around Christmas 2022.
- 2024: Maintainer publishes a project history post explaining the digest-based approach.
- 2026: The batch input lists Homebrew distribution for dockcheck.

### Related projects

- Dockcheck is adjacent to Watchtower-style container updaters, Docker Compose maintenance scripts, regclient/regctl, and the podcheck fork for Podman users.

### Sources

- <https://github.com/mag37/dockcheck#readme>
- <https://mag37.org/posts/project_dockcheck/>
- <https://formulae.brew.sh/formula/dockcheck>


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ./dockcheck.config, ~/.config/dockcheck.config
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** dockcheck
- **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


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure 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.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [regclient](https://www.automicvault.com/pkg/brew/regclient/) - Runtime dependency declared by Homebrew.
- [docker-gen](https://www.automicvault.com/pkg/brew/docker-gen/) - Shares av.db curated category or tags: automation, cli, containers, developer-tools, docker.
- [cdebug](https://www.automicvault.com/pkg/brew/cdebug/) - Shares av.db curated category or tags: cli, containers, developer-tools, docker.
- [cekit](https://www.automicvault.com/pkg/brew/cekit/) - Shares av.db curated category or tags: cli, containers, developer-tools, docker.
- [devcontainer](https://www.automicvault.com/pkg/brew/devcontainer/) - Shares av.db curated category or tags: cli, containers, developer-tools, docker.
- [docker](https://www.automicvault.com/pkg/brew/docker/) - Shares av.db curated category or tags: cli, containers, developer-tools, docker.
- [docker-buildx](https://www.automicvault.com/pkg/brew/docker-buildx/) - Shares av.db curated category or tags: cli, containers, developer-tools, docker.
- [docker-clean](https://www.automicvault.com/pkg/brew/docker-clean/) - Shares av.db curated category or tags: cli, containers, developer-tools, docker.
- [docker-compose](https://www.automicvault.com/pkg/brew/docker-compose/) - Shares av.db curated category or tags: cli, containers, developer-tools, docker.
- [docker-ls](https://www.automicvault.com/pkg/brew/docker-ls/) - Both packages work with overlapping file formats or content types. Shared terms: cli, containers, developer, developer-tools, docker.

## Combined YAML source

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


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
