Hangar

English | 简体中文

Hangar is a command line utility for container images with the following features:

• Multi-platform container images.
• Copy container images between registry servers.
• Export container images as archive files and import them into image repositories.
• Sign container images with sigstore key-pairs.
• Scan container image vulnerabilities.

Why use hangar?

• Hangar does not require any container runtime (daemon) to copy container images.
• Hangar is cross-platform and works in all Unix-like operating systems.
• Hangar supports both docker images and OCI images.
• Hangar supports copying/saving/loading/signing/scanning images in parallel to increase speed.
• Hangar is designed to export container images as archive files and import them into image repositories in Air-Gapped environments.

Genesis (interactive generate-list)

Live UI (GenesisRK): https://genesisrk.mftools.xyz — build image lists in the browser (Rancher version, distros, CNI, charts; export for mirror/save/Hauler).

Repository: github.com/aeltai/GenesisRK (standalone project; uses Hangar as a library for mirroring).

The genesis command (alias generate-list-genesis) generates image lists and Kubernetes version lists for Rancher air-gapped deployments. You can use an interactive TUI, a config file, or both:

# Interactive TUI: select distros (K3s/RKE2/RKE1), CNI, load balancer, and versions
hangar genesis --rancher=v2.13.1 --tui

# Config-driven (e.g. after saving selections from TUI); no prompts, ideal for CI/scripts
hangar genesis --rancher=v2.13.1 --config=config.yaml

In TUI mode, press q or Ctrl+C at any step to exit immediately (all steps are cancelled).

See hangar genesis --help for options and generate-list-config.example.yaml for a sample config.

Getting started

For documentation, visit the Hangar Documentation.

Contributing

Hangar is open-source and any issues or pull requests are welcomed if you have any suggestions while using Hangar.

License

Copyright 2025 SUSE Rancher

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.