Troubleshooting Guide
Find solutions to common BitOSDT issues. From installation problems to deployment errors, we've got you covered with step-by-step solutions.
Issue Categories
🔧
Installation Issues
Problems during application setup and prerequisite installation.
⚡
Runtime Errors
Issues with application functionality and OSDCloud integration.
🌐
Network Issues
PXE boot problems and network configuration issues.
🖥️
Deployment Issues
Problems with image creation and Windows deployment.
Installation Issues
⚠️
Prerequisites Fail to Install
Symptoms:
- Installation hangs during prerequisite download
- Error messages about failed downloads
- PowerShell module installation fails
- Windows ADK installation errors
Solutions:
- Check internet connectivity and ensure stable connection
- Temporarily disable antivirus software during installation
- Run installer as Administrator
- Check Windows Update service status
- Manually install PowerShell 7+ from Microsoft
- Ensure sufficient disk space (100GB+ free)
- Disable Windows Defender real-time protection temporarily
💥
Application Won't Start
Symptoms:
- Application crashes on startup
- Blank window or loading screen
- Error messages in Event Viewer
- Application fails to respond
Solutions:
- Check Event Viewer for detailed error messages
- Verify all prerequisites are installed correctly
- Run system file checker:
sfc /scannow - Reinstall Visual C++ Redistributables
- Try running in compatibility mode
- Check for Windows updates
- Reinstall BitOSDT if necessary
Runtime Errors
🖼️
Image Creation Fails
Symptoms:
- Image build process stops unexpectedly
- Error messages during image creation
- OSDCloud module errors
- Download failures for Windows images
Solutions:
- Ensure sufficient disk space (100GB+ free)
- Verify OSD PowerShell module is up to date
- Check internet connectivity for downloads
- Run PowerShell as Administrator
- Temporarily disable real-time antivirus scanning
- Check Windows ADK installation
- Verify system meets minimum requirements
- Try creating a simpler image configuration
🔧
Driver Detection Issues
Symptoms:
- Drivers not detected during deployment
- Hardware not recognized after deployment
- CloudDriver option not working
- Missing device drivers
Solutions:
- Enable CloudDriver option in image creation
- Manually add driver packages if needed
- Verify device is supported by OSDCloud
- Check manufacturer driver availability
- Use Windows 10 template for better compatibility
- Update OSDCloud module to latest version
- Test with different hardware configurations
Network Issues
⚠️ Beta Notice: PXE Server Mode and network boot features are disabled during beta testing. These solutions apply to future releases.
🌐
Web Interface Not Accessible
Solutions (for future releases):
- Check Windows Firewall settings (allow port 3000)
- Verify port 3000 is not in use by another application
- Check antivirus network protection settings
- Try changing the port in application settings
- Ensure server mode is enabled during installation
- Check network adapter configuration
🔌
PXE Boot Not Working
Solutions (for future releases):
- Verify network configuration (DHCP scope options)
- Check DHCP options 66 and 67 are correctly set
- Ensure TFTP service is running (port 69)
- Verify device MAC address is in allowed list
- Check network boot is enabled in device BIOS/UEFI
- Ensure Windows Firewall allows DHCP and TFTP
- Test with different network hardware
Deployment Issues
💾
USB Creation Fails
Symptoms:
- USB drive not recognized
- Creation process hangs or fails
- USB drive not bootable after creation
- Insufficient space errors
Solutions:
- Ensure USB drive is 8GB or larger
- Format USB drive as FAT32 before creation
- Try a different USB port or drive
- Run BitOSDT as Administrator
- Check USB drive for errors
- Disable antivirus real-time scanning temporarily
- Verify USB drive is not write-protected
📀
ISO Creation Problems
Solutions:
- Ensure sufficient disk space for ISO file
- Check write permissions for target directory
- Verify image build completed successfully
- Try creating ISO in different location
- Close any applications using the target drive
- Check for disk errors on target drive
Common Error Codes
Error 0x80070002: File not found. Check that all required files are present and paths are correct.
Error 0x80070005: Access denied. Run as Administrator or check file permissions.
Error 0x8007000E: Out of memory. Close other applications or increase virtual memory.
Error 0x80070070: Insufficient disk space. Free up disk space and try again.
Error 0x80070091: Directory not empty. Clear the target directory or choose different location.
Error 0x8007045D: I/O device error. Check USB drive or disk for errors.
Getting Help
Support Resources
- Documentation: Check our comprehensive guides and tutorials
- Community Forums: Connect with other BitOSDT users
- Issue Tracker: Report bugs and request features
- Email Support: support@bitosdt.com
When Reporting Issues
Include the following information for faster resolution:
- Detailed error messages and codes
- System specifications (OS, RAM, disk space)
- Steps to reproduce the issue
- Screenshots or log files if available
- BitOSDT version and build number
💡 Pro Tip: During beta testing, many issues are known and being addressed. Check our issue tracker for known issues and workarounds.