Commands Overview

Global flags

These flags apply to all commands:

Flag	Env var	Default	Description
--config string	IMGLIFE_CONFIG	imglife.yaml	Path to the configuration file
--log-format string	IMGLIFE_LOG_FORMAT	json	Log format: json or text
--log-level string	IMGLIFE_LOGLEVEL	warn	Log level: debug, info, warn, error
--check	—	—	Validate config without executing

Example:

# Validate config
imglife --config myconfig.yaml --check

# Debug output with text logs
imglife --log-format text --log-level debug sync --dry-run

Command reference

Command	Description
sync	Mirror upstream images to your private registry
build	Generate Dockerfiles and build base images
cleanup	Apply retention policy and delete stale tags
register	Publish a build record for an applicative image
status	Generate a Markdown status report
check	Verify an applicative image’s base is current
images	List images in the registry
app list	List applicative build records
app purge	Purge stale applicative build records
eol update	Refresh EOL data from endoflife.date
version	Print imglife version
completion	Generate shell completion scripts

Typical pipeline order

imglife sync      →  mirror upstream images
imglife build     →  build base images from mirrors
imglife eol update →  refresh EOL cache (optional)
imglife status    →  generate README
imglife cleanup   →  apply retention policy

Command reference pages

sync Mirror public images to your registry.

build Build base images from Dockerfile templates.

cleanup Delete stale tags according to your retention policy.

register Record an applicative build in the Package Registry.

status Generate a Markdown status report.

check Verify a base image is current in applicative CI.

images Discover images in the OCI registry.

app Manage applicative build records.

eol Refresh EOL data from endoflife.date.

version Print version information.