deb-bootc-image-builder/devel/Troubleshooting.md

1,023 B

Troubleshooting

Common issues and solutions when working with deb-bootc-image-builder.

Build Issues

Go module download failures

If you encounter issues with Go module downloads, ensure your GOPROXY is set correctly:

export GOPROXY=https://proxy.golang.org,direct

Permission issues

Some operations may require elevated privileges. Ensure you have the necessary permissions or use sudo where appropriate.

Runtime Issues

Container storage issues

If you encounter container storage issues, check that the required volumes are properly mounted and accessible.

Package installation failures

Ensure your Debian package sources are up to date:

apt-get update

Test Issues

Integration test failures

Integration tests require specific dependencies. Ensure all test dependencies are installed as outlined in the main README.

Cross-architecture build issues

Cross-architecture builds require proper Go toolchain setup. Ensure GOOS and GOARCH are properly configured.