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

33 lines
1,023 B
Markdown

# 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:
```bash
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:
```bash
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.