Docker Compose Refresher

@shelson/docker-compose-refresherv2026.06.28.4· 9d agoMODELS

01README

Keep :latest-tagged (and untagged) services in local or SSH-reachable docker compose projects up to date. Compares each running container's image digest against the registry (docker buildx imagetools) so already-current services are left untouched, then pulls and recreates only stale ones with a health-gate. Dry-run by default. Supports sudo-prefixed docker and per-host SSH config.

02Models1

@shelson/docker-compose-refresherv2026.06.28.4compose_refresher.ts

Global Arguments

Argument	Type	Required	Description
hosts	array	yes	Hosts to scan for compose projects
matchTags	array	yes	Image tags (after the colon) that trigger a refresh
alsoRefreshUntagged	boolean	yes	Also refresh image refs with no explicit tag (docker treats these as :latest)
denyImagePatterns	array	yes	Substring patterns (case-insensitive); matching images are never refreshed
maxPerRun	number	yes	Hard cap on refreshes per run. 0 = unlimited.
healthCheckTimeoutSec	number	yes	Seconds to wait for a recreated container to reach running/healthy before flagging unhealthy
dockerBin	string	yes	Docker binary name/path on each host

fn refresh(apply: boolean, skipImages: array, onlyProjects: array, onlyHosts: array)

Discover compose projects on every host, find services whose image tag is :latest (or untagged), compare local vs registry digests (buildx imagetools) to confirm an update is actually pending, then pull + recreate. Dry-run by default (apply=false).

Argument	Type	Required	Description
apply	boolean	yes	If true, actually pull + recreate. If false (default), dry-run.
skipImages	array	yes	Image refs to spare this run (exact match).
onlyProjects	array	yes	Restrict to these compose project names (empty = all).
onlyHosts	array	yes	Restrict to these host names (empty = all).