Skip to content

fix: report missing EROFS dependency - #598

Open
dominikpalatynski wants to merge 1 commit into
kernel:mainfrom
dominikpalatynski:fix/missing-erofs-dependency
Open

dominikpalatynski wants to merge 1 commit into
kernel:mainfrom
dominikpalatynski:fix/missing-erofs-dependency

Conversation

@dominikpalatynski

@dominikpalatynski dominikpalatynski commented Nov 22, 2026 •

Copy link
Copy Markdown

Summary

While trying out Hypeman and creating a VM from an image, I encountered an error caused by a missing dependency:

hypeman run --name my-app nginx:alpine
image build failed: convert to erofs: mkfs.erofs failed: exec: "mkfs.erofs": executable file not found in $PATH, output:

The installer had reported success, so I think it would be helpful to notify users earlier, during installation. This PR checks for mkfs.erofs in the Linux installer and adds an actionable error message when image conversion cannot find it. Both errors explain how to install erofs-utils on Ubuntu/Debian.

scripts/install.sh       Check for mkfs.erofs during Linux pre-flight
lib/images/disk.go       Explain how to install the missing dependency
lib/images/disk_test.go  Cover the missing-tool error and recovery command
README.md               List erofs-utils in Linux requirements

Evidence

  • Before: The command above failed with a raw executable-not-found error. The new regression test fails against the previous error handling, verified with a temporary Go overlay.
  • After: TestExportRootfsWithContextMissingErofsTool passes. A direct exporter smoke run reports the missing tool and sudo apt-get install erofs-utils, while preserving exec.ErrNotFound.

Checks run:

bash -n scripts/install.sh
go test -tags containers_image_openpgp ./lib/images \
  -run '^TestExportRootfsWithContextMissingErofsTool$' -count=1

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant