Installation Issues

Common install problems on Windows and macOS.

Before install

Windows

Windows 7 SP1+ (Windows 10/11 recommended)
4 GB+ RAM, 2 GB+ free disk
.NET Framework 4.7.2+ and VC++ 2015–2022
Administrator rights for setup

Download

GitHub Releases only
Verify SHA256 if provided
Temporarily allow the installer in antivirus

Permission denied

Right-click installer → Run as administrator
Approve UAC prompt
Or grant write access to the target folder

Installer does nothing

Install pending Windows updates
Repair .NET / VC++ redistributables
Re-download the latest package
Ensure Windows Installer service is running

Install hangs or fails mid-way

Wait 5–10 minutes; check disk space
Disable other installers
Retry after reboot

After install: won’t open

See Installation guide
macOS: xattr -d com.apple.quarantine on the app bundle
Check logs under user data / AppData

Antivirus blocks the app

Add install dir and executable to exclusions
Report false positive to your AV vendor

macOS Gatekeeper

bash

xattr -d com.apple.quarantine "/Applications/VirtualBrowser.app"

Still failing?

Common issues · GitHub Issues

Include OS build, installer version, and screenshots of the error.