🛠️ Troubleshooting Guide
Find solutions to common issues and get your Anti-Detect Browser working smoothly.
🔥 Most Common Issues
The most common startup issue is usually related to missing dependencies or insufficient permissions.
Ensure your system meets the minimum requirements: 4GB RAM, 1GB storage, Windows 10/macOS 10.14/Ubuntu 18.04 or later.
Right-click the application and select "Run as administrator" (Windows) or use sudo (Linux/macOS).
Add the application to your antivirus whitelist. Some security software may block browser automation tools.
Download the latest version and perform a clean installation.
If websites are detecting your automated browser, your fingerprint protection may need adjustment.
Go to Settings > Fingerprints > Update Database to get the latest fingerprint profiles.
Create profiles with the latest Chrome/Firefox versions. Outdated browsers are easier to detect.
Use different IP addresses and geographic locations for each session.
Increase canvas fingerprint randomization in Profile Settings > Advanced > Canvas Protection.
Performance issues can be caused by proxy speed, system resources, or protection settings.
Use the built-in proxy tester to check connection speed and switch to faster proxies.
Lower fingerprint protection settings for better performance if detection isn't critical.
Limit concurrent browser sessions based on your system's capabilities.
Regularly clear cache, cookies, and browsing data to improve performance.
💾 Installation Issues
Re-download the installer from the official website to ensure it's not corrupted.
Some antivirus software may interfere with installation. Disable it temporarily during installation.
Ensure you have at least 2GB of free disk space for installation.
Try installing to a different location if the default directory has permission issues.
🌍 Browser Launch Problems
Ensure all required profile fields are completed and valid.
Verify the selected proxy is working and accessible.
Ensure the debug port (usually 9222) is not being used by another application.
Download the latest browser engine from Settings > Browser Engines.
🌐 Proxy Connection Issues
Double-check username and password for typos and correct case sensitivity.
Ensure you're using the correct proxy type (HTTP, HTTPS, SOCKS4, SOCKS5).
Verify proxy credentials work with another application or browser.
If credentials are correct, contact your proxy service provider for support.
Ensure your internet connection is stable and working.
Switch to a different proxy server from your provider's list.
Increase connection timeout in Settings > Network > Proxy Timeout.
Ensure your firewall isn't blocking proxy connections.
🛡️ Fingerprint Protection Issues
Activate maximum protection in Profile Settings > Stealth Mode.
Use different user agents for each session and ensure they match the OS/browser combination.
Adjust WebGL fingerprint protection in Advanced Settings.
Add random delays and mouse movements to mimic human browsing patterns.
⚡ Performance Optimization
Reduce the number of simultaneous browser sessions based on available RAM.
Turn on memory optimization in Settings > Performance > Memory Management.
Regularly close tabs and windows that are no longer needed.
Restart browser sessions every few hours to clear memory leaks.
🤖 Automation Issues
Verify your JavaScript code for syntax errors using browser developer tools.
Ensure automation is enabled in the browser session settings.
Include appropriate wait times for page loads and element availability.
Wrap your code in try-catch blocks to handle errors gracefully.
🔧 API Error Codes
| Error Code | Description | Solution |
|---|---|---|
| 401 | Unauthorized - Invalid API key | Check your API key and ensure it's correctly formatted |
| 429 | Rate limit exceeded | Reduce request frequency or upgrade your plan |
| 500 | Internal server error | Retry the request or contact support if persistent |
| 503 | Service temporarily unavailable | Wait and retry, or check status page for maintenance |
🔍 Diagnostic Tools
🔧 System Diagnostic
Run a comprehensive system check to identify potential issues.
🌐 Network Diagnostic
Test network connectivity and proxy configurations.
🛡️ Fingerprint Test
Verify fingerprint protection is working correctly.