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
config validate	Validate the configuration and print a summary
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

syncMirror public images to your registry.

buildBuild base images from Dockerfile templates.

cleanupDelete stale tags according to your retention policy.

registerRecord an applicative build in the Package Registry.

statusGenerate a Markdown status report.

checkVerify a base image is current in applicative CI.

imagesDiscover images in the OCI registry.

appManage applicative build records.

eolRefresh EOL data from endoflife.date.

versionPrint version information.