mirror-images flag reference

The mirror-images tool accepts the following flags to control how it mirrors Red Hat Edge Manager container images and optional RPMs on a connected prep machine.

Table 1. mirror-images command-line flags
Flag Default Description

--variant

—

Deployment variant: rhem-el9 or rhem-el10. Required unless --agent-only is set.

--dest-registry

localhost:5000 (bundle mode)

Destination registry host:port (no scheme). Required in live-push mode.

--execute

false

Execute skopeo copy commands immediately. Mutually exclusive with --bundle.

--insecure

false

Disable TLS verification for the destination registry. Required for plain HTTP registries.

--tag-override

—

Pin the image tag for all untagged Red Hat Edge Manager service images (for example 1.3.0). Also pins the RPM version automatically when --bundle-rpms or --agent-only is set. Third-party images with explicit tags are unaffected.

--bundle

—

Create a self-contained .tar.gz archive at the given path. Mutually exclusive with --execute.

--bundle-rpms

false

Include RPMs and an install-rpms.sh script in the bundle. Requires --bundle.

--rpm-packages

flightctl-services, flightctl-cli, flightctl-agent

Comma-separated list of RPM packages to download into the bundle. The flightctl-greenboot subpackage is pulled as a Recommends: dependency of flightctl-agent and is included in downloads that use --alldeps. Package-mode hosts do not need flightctl-greenboot.

--rpm-exclude

—

Comma-separated packages to download but skip during auto-install. RPMs remain in rpms/ for manual use (for example embedding flightctl-agent into device operating system images).

--rpm-repo-url

—

URL of a .repo file used when you download RPMs from a custom offline repository instead of enabled subscription repositories.

--rpm-createrepo

false

Run createrepo_c after dnf download to generate repodata/ in the bundle. Prevents dnf protected-package conflicts on install. Mutually exclusive with --rpm-reposync.

--rpm-reposync

false

Mirror the full Red Hat Edge Manager RPM repository by using dnf reposync, including repodata. Requires dnf-plugins-core. Mutually exclusive with --rpm-createrepo.

--agent-only

false

RPM-only bundle for edge device installation. Skips all image bundling; --variant is not required. Defaults --rpm-packages to flightctl-agent, flightctl-cli, open-vm-tools, ignition, afterburn, cloud-init. The bundle includes flightctl-greenboot as a weak dependency of flightctl-agent. Package-mode hosts do not need this subpackage; exclude it at install time by using --setopt=install_weak_deps=False.