Troubleshooting Known Issues

Q: What does the "Service Unavailable" error mean?

A: A Service Unavailable error indicates that there is a temporary partial disruption affecting one or more Kameleo services. This can result in short-term connectivity or functionality issues for some users.

In most cases, this is temporary and resolves automatically once the affected service stabilizes.

Q: I’m having connection issues. Did Kameleo block my IP address?

A: No. Kameleo does not block or restrict customer IP addresses.

We do not apply IP-based bans or limitations. If you’re experiencing connection problems, they are usually caused by external factors such as:

• Network or ISP routing issues
• Firewall or antivirus software blocking traffic
• Proxy or VPN misconfiguration
• Temporary issues with external services (e.g. proxy providers or CDN routing)

If the issue continues, please contact support and include:

• Relevant log files
• The approximate time the issue occurred
• Whether you were using a proxy or VPN

This information helps us identify the root cause more quickly.

Q: Kameleo isn’t opening. What should I do?

A: If Kameleo does not start even after restarting your computer, try the following steps:

1. Run as Administrator

   Right-click the Kameleo shortcut and select Run as administrator.

2. Check for Background Processes

   Open Task Manager and look for any running Kameleo processes. End them and try launching the app again.

3. Check Port Usage

   Kameleo uses a local port (default: 5050). Ensure no other application is using this port. You can change the port in Kameleo’s settings if needed.

4. Reinstall Kameleo

   Uninstall the application and reinstall the latest version from the official website.

5. Firewall Settings

   Make sure Kameleo is allowed through your firewall: Control Panel → Windows Defender Firewall → Allowed apps

6. Check for Error Messages

   Any displayed errors or log entries may provide clues about the issue.

If none of these steps resolve the problem, contact our support for further assistance.

Q: I get the error "Failed to start upstream proxy process (10 sec timeout)" when starting a profile.

A: This error means that the local proxy process could not start within the 10-second limit. Currently, this timeout value cannot be increased.

Common causes include:

• Invalid SSH or SOCKS5 proxy credentials
• Incorrect proxy host or port
• Network or firewall restrictions
• No available free TCP port on your system (rare)

What you should do:

• Double-check proxy host, port, username, and password
• Verify that the proxy is reachable and active
• Ensure your firewall or network setup is not blocking the connection

If the issue persists, please provide the following to support:

• Operating system version
• Kameleo version and login name
• Proxy or VPN provider name and IP country
• Proxy type (Direct / SOCKS / HTTP / VPN)
• Any relevant network configuration details

Q: I get the error "Access to the path is denied" when starting a profile. What does this mean?

A: This error is usually caused by insufficient file system permissions on your device.

How to fix it:

1. Locate the folder

   Navigate to the path shown in the error message (commonly:

   C:\Users\USERNAME\AppData\Local\Temp\ )

   Check folder permissions

   • Right-click the folder → Properties
   • Go to the Security tab → Advanced
   • Click Change next to the owner and enter your username

   • Enable Replace owner on subcontainers and objects

     Modify permissions

   • Under Permissions, select your user account
   • Click Change permissions
   • Enable Replace all child object permission entries

2. Restart your computer

   This ensures the new permissions are applied correctly.

Re-downloading Kameleo is not necessary in most cases. If the error continues after these steps, contact support for further help.

Q: I'm getting an error in Profile Hub communication. It says 'InvokeCoreAsync' method can't be called if the connection isn't active.

A: The error message "'InvokeCoreAsync' method can't be called if the connection isn't active" typically means that Kameleo is having trouble maintaining a connection with the Profile Hub service, which is essential for managing browser profiles.

Could you please provide more details?

• When does this error occur (e.g., at startup, when starting a profile, etc.)?
• Are you able to use other features of the app, or is everything affected?
• Have you noticed any network issues or firewall restrictions on your device?

Additionally, since this is a technical issue within the desktop app, the best way to report it is by using the "Report Bug" feature inside the Kameleo application. This will automatically collect important diagnostic information to help our technical team investigate and resolve the issue more efficiently.