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.

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.

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.

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.

Free Trials

One more tip for new free trial users: You are limited to 100MB of bandwidth. If you exceed this limit within 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.

Still need help? Contact Us Contact Us