# 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.
