How to Get Started with ProxyMesh

This article describes how to use the dashboard to set up your ProxyMesh account and system browser to use our service effectively.

Setting up Your Username

Every account requires a username, which must be unique. Some users choose to use their email address as their username. Others prefer a different username.

Making your email address the username is acceptable, but we do not advise it, as the @ "at" sign can interfere with username:password authentication protocols. It’s better to choose a unique username without the “@“ symbol.

You can log in to ProxyMesh with either your username or the email address associated with your account.

Note that changing a username requires special procedures by the Support staff so that they can update your account records. Please contact ProxyMesh Support if you wish to change your username. Username change requests must come from the email address associated with your ProxyMesh account.

Watch for Confirmation Message

Once you sign up for a paid plan, ProxyMesh sends you a confirmation email, usually within a few minutes. Occasionally, however, it can take up to 30 minutes. If you attempt to make frequent requests to the proxy’s API before receiving your confirmation email, this can trigger a 402 error code, resulting in a temporary block of 4-6 hours.

Please note that ProxyMesh cannot manually remove this temporary block as the block is controlled by the hosting service or a remote site. You will need to wait until the temporary block is lifted before trying again. It's best not to make frequent requests to the proxy’s API.

After receiving your confirmation letter, follow these steps from your dashboard:


To initiate HTTP proxy requests, you'll need to provide either an authenticated IP address or basic access authentication. Here are the steps for each.

IP Address Authentication

  1. On your dashboard, choose Add an IP or Hostname link to add address(es) you wish to use.
  2. Fill and submit the form. Any IP address you add will be able to access the ProxyMesh proxy without a Proxy-Authorization header. If you have a dynamic, frequently changing IP, then you may want to use domain authentication with a dynamic DNS service.

Please note that after you add an IP to your account, it should be authorized at the servers within a few minutes. Please be sure you do this first before you make requests from that IP to avoid a temporary block.

Basic Access Authentication

Configure the Proxy-Authorization header for your requests, containing your username and password in the format USERNAME:PASSWORD. Most HTTP client libraries support the basic access authentication method. For those libraries that do not support it, you can create the header yourself:

  • If needed, Base64 encode your username:password
  • Send a header that looks like this: Proxy-Authorization: Basic base64-encoded-username:password
  • Many Unix/Linux clients support the HTTP proxy environment variable, or even rely on it exclusively. For those clients, use the following command:

Select one or more proxies

On your dashboard select Change Proxies. Select or deselect proxies from the list, as needed, and with the number based on your plan limit. On the free trial, you can select any one proxy; however, you should be aware of the allowed limit for each paid Proxy plan when upgrading.

All of our proxies are data center proxies. Each proxy offers IPv4 addresses.

Configure the HTTP client

You must configure the Proxy Host with basic authentication in various HTTP clients. We've provided the code you need in a range of popular programming languages:

To configure an HTTPS client, additional steps are required, as documented here.

Configure your browsers

ProxyMesh services work on most popular browsers. The simplest way to configure your browser is to add your IP address for authentication and then use one of the proxy.pac links as the proxy auto-configuration url in your browser settings.

If you use Firefox or Chrome, the FoxyProxy plugin makes it really easy to configure your proxy settings. See these articles for specifics about add-ons:

You'll find all of these access links on your user dashboard.

2-Factor Authentication

2-Factor Authentication is a way to enhance your account security. It requires a secondary password that changes each time you log in.

Under Account Settings on the right side of your dashboard is a 2-Factor Authentication link. Click this link to go to the 2-Factor Authentication screen. On that screen, click either the Google Authentication or the Authy link. Then click the Enable link. A code/token will be sent to your app or mobile device.

If you enable one of these methods, then each time you log in to your account, a different token will be sent to your app or mobile device. You will be required to enter the secondary token to complete login. This will protect you in case your account username and password are somehow stolen or compromised.

Return to the dashboard via the Back button or click the Dashboard link on the ribbon.

Note: If you want to discontinue using 2FA, you will need to contact Support to disable it.

Prepaid Bandwidth

If you purchase the 100 plan and expect to use bandwidth beyond your plan limit, consider purchasing prepaid bandwidth at a reduced rate. Prepaid bandwidth is available only to customers on the 100 plan. For more details, please see our Prepaid Bandwidth article.

Free Trials

One more tip for new free trial users: You are limited to 100MB of bandwidth. If you exceed this limit before the end of your 30-day trial period, your service will be cancelled. Please track your usage carefully, and if this constraint does not meet your needs, you have the option of upgrading at any time to one of our paid plans.

Contacting Support via Chat Logs or Email

If you need to contact Support via our chat logs or email, please remember that our staff are hard-working and courteous and are trying to help you in a timely manner. Offensive language and abusive behavior towards Support staff will not be tolerated, and may be cause for canceling your subscription.

Read More about Proxies

If you'd like more information about proxy services, please visit our companion website, We hope you'll find our blog to be a good resource for learning about the different types of proxy services and determining your needs.

Still need help? Contact Us Contact Us