Known Issues and Limits
Please report any issues to Hauler, Hauler Helm, or Hauler Docs.
Breaking Changes​
Please see the release notes for full details.
| Release Version | Change |
|---|---|
| v2.1.1 | --platform is rejected with a digest-pinned multi-platform index |
| v2.1.1 | errors retrieving signatures, attestations, SBOMs, and referrers fail the image instead of being skipped |
| v2.1.0 | hauler store add image and hauler store sync fail when an image fails signature verification, instead of skipping it... with --ignore-errors the unverified image is stored with a warning |
| v2.1.0 | hauler store info -o json changed shape |
| v2.1.0 | flag precedence is CLI first, then per-item fields, then manifest annotations |
| v2.0.0 | removed apiVersion: hauler.cattle.io/v1alpha1... use hauler.cattle.io/v1 |
Known Limitations​
These are current limitations of Hauler, with workarounds included where available.
| Command or Area | Limitation |
|---|---|
hauler store load | podman generated tarballs are not supported and may not load every image |
hauler store copy | copying to a registry path requires hauler login <registry-url> without the <path> first |
hauler store add chart | a chart with the same name as the store may fail to fetch, since helm checks for a local directory with that name first |
| temporary space | defaults to the os temp directory (i.e. /tmp), which needs as much free space as the store or haul... or set --tempdir / HAULER_TEMP_DIR |
| homebrew | versioned casks (hauler@<version>) never upgrade... use hauler or hauler-dev to receive upgrades |
Experimental Features​
Commands and flags marked (EXPERIMENTAL) are not yet stable and may change in a future release.
| Release Version | Command or Flag |
|---|---|
| v2.1.1 | hauler store copy --type |
| v2.1.1 | hauler store serve registry --basic-auth / --basic-auth-realm |
| v2.1.1 | hauler store serve fileserver --basic-auth / --basic-auth-realm |
| v2.1.0 | hauler store create manifest |