ovoBrowser Frequently Asked Questions and Troubleshooting

This page summarizes the most common problems when using ovoBrowser. First check the corresponding item; if the problem still cannot be solved, please click "Contact Us" in the upper right corner of the client and provide the client version, occurrence time, profile number, error message and reproducible steps. Do not send proxy passwords, account passwords, Cookie or 2FA keys.

Install, log in and update

What should I do if the client cannot be started?

1. Confirm that the installation has been completed, do not directly run the temporary files in the installation package;

2. End the remaining ovoBrowser process in the task manager and reopen it;

3. Temporarily exit any security software that may block the launch of the program and try again;

4. Re-download and install the latest version of the client and overwrite the installation;

5. If the launch page shows that a step failed, click "Recheck" and record the failed step and complete prompts.

What should I do if I can’t receive the email verification code?

1. Make sure the email address is spelled correctly;

2. Check spam, spam and email quarantine;

3. Wait for the countdown to end and reacquire it;

4. Do not request verification codes frequently in a row;

5. Verification codes are valid for 10 minutes and only the last verification code received is used.

What should I do if I forget my password?

Click "Forgot Password" on the login page, enter your registered email and get a 6-digit verification code, and then set a new password. The password must be at least 10 characters long and contain a mix of uppercase letters, lowercase letters, and numbers. Team team member accounts should contact the team owner to reset their password.

What should I do if the update download fails?

Go to "Settings > System Settings > Version Information" to check for updates again. If the automatic update still fails, click "Download Installation Package" to manually overwrite the installation. Close all running profiles before installation.

Profile Management

Why can't I create or restore a profile?

Usually the profile quota is insufficient. Check the used profile quantity and total quota in the lower left corner of the client, delete the profiles you no longer need or increase the quota and try again. Restoring the profile in the Recycle bin will also occupy profile credits.

Why does the profile fail to start?

Check in the following order:

1. Check where the launch progress panel stops at the lower right corner;

2. Confirm that the target kernel has been downloaded, or keep the network open so that the client can download it automatically when it starts for the first time;

3. Recheck the proxy used in the profile in "Proxy Management";

4. Edit the profile and check whether the system, kernel, User-Agent, system version and other browser fingerprints settings match;

5. Close the remaining processes in the profile and try again;

6. If it still fails, record the profile number and the complete error in "launch failed". If it cannot be resolved, contact customer service.

Will tabs and login status be retained after closing the profile?

When the profile is closed normally from ovoBrowser, the client will save the tab page of this session and synchronize Cookie to the server. The configuration will be restored at next launch. When the process is forced to end, the computer is powered off, or the network is interrupted, the last change may not be saved in time.

What is the difference between deleting a profile and clearing cache?

• "Delete profile" will move the profile to the Recycle bin, and the profile will no longer appear in the profile list;

• "Also delete profile local cache" will additionally delete the browsing data on the current computer;

• "Settings > Cache Settings > Clear Cache" only clears the local cache of non-running profiles and will not delete cloud profile records;

• "Recycle bin > Complete Delete" will permanently delete the profile record and cannot be restored.

proxy network

What should I do if the proxy test fails?

First confirm that the protocol, host, port, user name and password are completely consistent with the information provided by the proxy provider, and then check Proxy Test Failures and Configure HTTP, HTTPS, SOCKS5 proxies. Common reasons include proxy expiration, whitelist failure, authentication errors, the local network cannot connect to the proxy server, or the proxy provider restricts the target area. Please contact your proxy provider.

What should I do if the test is successful but the website still cannot be opened?

1. Confirm that you are opening the same proxy that was just detected;

2. Check whether the proxy restricts the target website or port;

3. Change the "IP query channel" in the profile and test again;

4. Check whether the computer's system proxy, VPN or security software has changed the network link;

5. Contact the proxy provider to confirm whether the exit IP is normal.

Can direct connection isolate public IP addresses in different profiles?

No. The direct connection profile uses the actual internet connection of the current computer; if the computer has a system proxy enabled, it may also export through the system proxy. Multiple direct-connect profiles typically share the same public IP. If network isolation is required, different profiles should be assigned different available proxies.

Teams, permissions and sharing

Why can't I see a menu or button?

Team roles control menu and operation permissions. If you cannot see functions such as "Team Management", "Window Sync" and "API & MCP", or the buttons are disabled, please contact the team owner to check the role permissions and package benefits. The permissions will take effect immediately after being saved. If necessary, refresh the data or re-enter the page.

Why do I need to select a resource receiver before deleting a member?

Deleting a member is an irreversible operation. The profile, groups, and proxies owned by this member need to be transferred to the receiver who is still on the team to avoid losing the ownership of business data. Please confirm the conservator first, and then enter the member account required on the page to complete the second confirmation.

What is the difference between revocable sharing and irrevocable sharing?

Both methods will create an independent copy for the recipient, and subsequent modifications by both parties will not affect each other. Revocable sharing allows the sender to later withdraw and delete the recipient's copy; irrevocable sharing cannot be withdrawn by the sender and the recipient can continue to share.

Window Sync and expansion

What should I do if the Window Sync list is empty?

Window Sync only displays the currently open profile. Please open at least two profiles in "Profile Management" first, then return to "Window Sync" and click Refresh. Also confirm that the current role has Window Sync permissions.

What should I do if the text is not entered into the follow window?

First click on the text box that needs to be entered in each target window to get focus, and then send the text. If there are multiple input boxes on the page, the page refuses script writing, or the window connection is disconnected, the console will give the reason for the failure.

What should I do if the extension is added but not loaded in the profile?

Confirm that the extension status is "Enabled" and any of the following conditions are met: "Apply to all profiles" is turned on, or the target profile is checked in "Assign profiles". The extended settings will take effect the next time the profile is started, and the running profile needs to be closed and reopened.

API & MCP

Calling local API prompts Connection refused

1. Keep the ovoBrowser client running and logged in;

2. Open the "API & MCP" page;

3. Confirm that "Service is running" is displayed;

4. Use the endpoint URL displayed on the page and do not assume that the port must be 50325;

5. Verify that the request was sent to 127.0.0.1 and was not overwritten by the container, VM, or proxy.

Does local API need Token?

No need. The current local API only listens to 127.0.0.1 and does not use Token, Bearer Token or x-api-key. Do not expose this service to the local or public network through port forwarding, reverse proxies, or tunnels.

Why is the HTTP status 200 but the operation still fails?

Some business errors will return HTTP 200, and use {"success":false,"msg":"错误说明"} in the response body to indicate failure. The calling program must check success, not just the HTTP status code.

Cache and disk

Will clearing the cache result in losing the account login status?

Clearing the cache will delete the browsing data of the non-running profile on this machine. After a graceful close of the profile, Cookie saves a server snapshot that can be re-injected later, but there is no guarantee that all local storage for all websites can be restored. Before important business operations, you should shut down the profile normally and confirm that key data has been saved.

Why is it still occupied after clearing the cache?

The running profile will be automatically skipped; the client's own files, kernel files and installation files do not belong to the "profile cache". Close all profiles first, then refresh the cache information and try again.

What to prepare before contacting support?

Please prepare:

• ovoBrowser client version;

• Windows version;

• When the problem occurred;

• profile number (do not send account password);

• Complete error message;

• Steps from opening the page to when the problem occurs;

• Necessary screenshots or screen recordings;

• Proxy questions can provide the protocol, host and port, but please hide the username and password.