Troubleshooting

Structured steps to diagnose and fix common Virtual Browser issues.

Workflow

1. Describe what happened
2. Collect logs and config
3. Identify cause
4. Apply fix
5. Confirm resolution
6. Note prevention steps

Profile won’t start

Symptoms: No window, crash, or “launch failed”.

Checks:

• Free RAM and disk under %APPDATA%\VirtualBrowser (Windows) or app data on Mac
• Logs in %APPDATA%\VirtualBrowser\logs\
• Proxy and profile JSON validity

Fixes:

1. Quit all Virtual Browser processes; clear %TEMP%\VirtualBrowser (Windows); relaunch
2. Repair or recreate the profile; restore from backup if needed
3. Reduce concurrent launches

Fingerprint detected

Symptoms: CAPTCHA, “unusual activity”, temporary limits.

Checks:

• BrowserLeaks, FingerprintJS
• Language/timezone vs proxy geo
• Action timing (too fast / repetitive)

Fixes:

• Tighten fingerprint consistency (screen, Canvas, WebGL, fonts)
• Use residential proxies in the target region
• Slow down navigation and input; avoid identical bulk actions

Proxy problems

Symptoms: Timeouts, auth errors, very slow pages.

Checks:

curl -x http://user:pass@host:port https://httpbin.org/ip

Verify type (HTTP/SOCKS5), credentials, firewall.

Fixes:

• Correct host / port / protocol
• Rotate pool with health checks
• Try alternate DNS (8.8.8.8, 1.1.1.1)

Performance

Symptoms: High RAM/CPU, UI lag.

Fixes:

• Run fewer profiles at once (often ≤8 on 16 GB RAM)
• Clear cache; restart client daily on heavy workloads
• SSD recommended for profile data

Missing data

Symptoms: Lost settings, cookies, or profiles.

Fixes:

1. Restore from export/backup
2. Enable regular export; Pro users may use cloud sync
3. Fix folder permissions on the user data directory

Logs

Typical Windows path:

%APPDATA%\VirtualBrowser\logs\
├── app.log
├── browser.log
├── network.log
└── error.log

Enable verbose logging in client settings when support asks for traces.

Maintenance checklist

Daily: app running; proxy OK; disk space
Weekly: clear temp/cache; spot-check fingerprints
Monthly: backup configs; update client

Report an issue

Include: version, OS, steps to reproduce, logs, profile count, proxy type.

• GitHub Issues
• Discussions
• security@virtualbrowser.cc (security reports)
• support@virtualbrowser.cc

More FAQ: Common issues.