🛠️ Troubleshooting

🛠️ Troubleshooting Guide

Find solutions to common issues and get your Anti-Detect Browser working smoothly.

🔥 Most Common Issues

❌ Application Won't Start

The most common startup issue is usually related to missing dependencies or insufficient permissions.

Check System Requirements

Ensure your system meets the minimum requirements: 4GB RAM, 1GB storage, Windows 10/macOS 10.14/Ubuntu 18.04 or later.

Run as Administrator

Right-click the application and select "Run as administrator" (Windows) or use sudo (Linux/macOS).

Check Antivirus Software

Add the application to your antivirus whitelist. Some security software may block browser automation tools.

Reinstall Application

Download the latest version and perform a clean installation.

💡 Pro Tip: Check the application logs in the installation directory for specific error messages.
⚠️ Browser Detected by Websites

If websites are detecting your automated browser, your fingerprint protection may need adjustment.

Update Fingerprint Database

Go to Settings > Fingerprints > Update Database to get the latest fingerprint profiles.

Use Recent Browser Versions

Create profiles with the latest Chrome/Firefox versions. Outdated browsers are easier to detect.

Rotate Proxies Frequently

Use different IP addresses and geographic locations for each session.

Adjust Canvas Protection

Increase canvas fingerprint randomization in Profile Settings > Advanced > Canvas Protection.

⚠️ Warning: Higher protection levels may cause compatibility issues with some websites.
🐌 Slow Browser Performance

Performance issues can be caused by proxy speed, system resources, or protection settings.

Test Proxy Speed

Use the built-in proxy tester to check connection speed and switch to faster proxies.

Proxy Manager > Select Proxy > Test Connection
Reduce Protection Level

Lower fingerprint protection settings for better performance if detection isn't critical.

Close Unnecessary Sessions

Limit concurrent browser sessions based on your system's capabilities.

Clear Browser Data

Regularly clear cache, cookies, and browsing data to improve performance.

💾 Installation Issues

Installation Failed or Corrupted
Download Fresh Installer

Re-download the installer from the official website to ensure it's not corrupted.

Disable Antivirus Temporarily

Some antivirus software may interfere with installation. Disable it temporarily during installation.

Free Up Disk Space

Ensure you have at least 2GB of free disk space for installation.

Install in Different Directory

Try installing to a different location if the default directory has permission issues.

🌍 Browser Launch Problems

Browser Session Fails to Start
Verify Profile Configuration

Ensure all required profile fields are completed and valid.

Test Proxy Connection

Verify the selected proxy is working and accessible.

Check Port Availability

Ensure the debug port (usually 9222) is not being used by another application.

Update Browser Engine

Download the latest browser engine from Settings > Browser Engines.

🚨 Common Error: "Port 9222 already in use" - Kill existing Chrome processes or change the debug port.

🌐 Proxy Connection Issues

Proxy Authentication Failed
Verify Credentials

Double-check username and password for typos and correct case sensitivity.

Check Proxy Type

Ensure you're using the correct proxy type (HTTP, HTTPS, SOCKS4, SOCKS5).

Test with Different Tool

Verify proxy credentials work with another application or browser.

Contact Proxy Provider

If credentials are correct, contact your proxy service provider for support.

Proxy Connection Timeout
Check Network Connectivity

Ensure your internet connection is stable and working.

Try Different Proxy Server

Switch to a different proxy server from your provider's list.

Adjust Timeout Settings

Increase connection timeout in Settings > Network > Proxy Timeout.

Check Firewall Settings

Ensure your firewall isn't blocking proxy connections.

🛡️ Fingerprint Protection Issues

Websites Still Detecting Automation
Enable Stealth Mode

Activate maximum protection in Profile Settings > Stealth Mode.

Randomize User Agents

Use different user agents for each session and ensure they match the OS/browser combination.

Update WebGL Settings

Adjust WebGL fingerprint protection in Advanced Settings.

Use Human-like Behavior

Add random delays and mouse movements to mimic human browsing patterns.

⚡ Performance Optimization

High Memory Usage
Limit Concurrent Sessions

Reduce the number of simultaneous browser sessions based on available RAM.

Enable Memory Optimization

Turn on memory optimization in Settings > Performance > Memory Management.

Close Unused Tabs

Regularly close tabs and windows that are no longer needed.

Restart Sessions Periodically

Restart browser sessions every few hours to clear memory leaks.

🤖 Automation Issues

Scripts Not Executing
Check Script Syntax

Verify your JavaScript code for syntax errors using browser developer tools.

Enable Automation Mode

Ensure automation is enabled in the browser session settings.

Add Proper Delays

Include appropriate wait times for page loads and element availability.

Use Try-Catch Blocks

Wrap your code in try-catch blocks to handle errors gracefully.

🔧 API Error Codes

Common API Error Responses
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.

💡 Need More Help? If these solutions don't resolve your issue, please visit our Help Center or contact our support team with your diagnostic results.