Before you start
The steps below use xx.xx.xx.xxx, port 5433, username proxyuser and password proxypass as examples. Replace them with the details shown for your proxy in your dashboard.
Have your proxy IP address, port and, if your plan uses them, username and password ready.
FoxyProxy is available for Chrome, Firefox, Edge, Brave and other Chromium browsers. There is no version for Safari — on a Mac with Safari, set the proxy in System Settings instead.
The proxy applies to the browser you install it in. Other programs on the computer keep using your normal connection.
Chrome cannot use SOCKS5 with a username and password
This is a Chrome limitation, not a FoxyProxy bug. If your proxy needs credentials, choose type HTTP or HTTPS in Chrome, or whitelist your computer's public IP address in your dashboard and leave the username and password empty. SOCKS5 with authentication only works in Firefox.
Step 1 — Install FoxyProxy and pin it
Open the Chrome Web Store, search for FoxyProxy, and click Add to Chrome, then Add extension.
This is a third-party app. We do not own it — use this official listing.
FoxyProxy Chrome → https://chromewebstore.google.com/detail/foxyproxy/gcknhkkoolaabfmlnjonogaaifnjlfnp
FoxyProxy Firefox → https://addons.mozilla.org/en-US/firefox/addon/foxyproxy-standard/
To keep the icon visible, open
chrome://extensions, click Details on FoxyProxy and turn on Pin to toolbar.
Chrome extension details, Pin to toolbar
Step 2 — Open the options and add a proxy
FoxyProxy icon → Options → Proxies → Add
Click the FoxyProxy icon, then Options at the bottom of the panel.
Open the Proxies tab and click Add.
FoxyProxy Options, Proxies tab, the Add button
Step 3 — Choose the proxy type
HTTP — use this for our HTTP/HTTPS proxies, including rotating packages. It is the right choice for almost everyone on Chrome.
HTTPS — only if your proxy endpoint itself is encrypted.
SOCKS5 — for SOCKS proxies. In Chrome this works only if the proxy has no username and password (whitelist your IP instead).
PAC — only if you were given a PAC file URL.
The other entries in the list are shortcuts for local tools such as Burp or Tor and are not used with our proxies.
The Type list: HTTP, HTTPS, SOCKS4, SOCKS5, QUIC, PAC, DIRECT
Step 4 — Enter your proxy details and save
Title — any name that helps you recognise the proxy, for example the city or the project.
Hostname — your proxy IP address or hostname. Do not include the port here.
Port — the port for that proxy.
Username and Password — only if your plan uses credentials. Leave both empty if you whitelisted your IP.
Country, City and Color are optional labels that make proxies easier to tell apart in the list.
Proxy DNS is greyed out in Chrome — it is a Firefox-only option.
Click Save.
Title, hostname, port, username and password filled in, then Save
Step 5 — Turn the proxy on
Click the FoxyProxy icon in the toolbar.
Click the proxy you just created. The icon changes colour to show a proxy is active.
Disable switches the proxy off and returns Chrome to its normal connection.
If your proxy needs a username and password, Chrome may ask for them once per session. Tick the option to remember them, or whitelist your IP to avoid the prompt.
The toolbar panel with the proxy selected
Check that it worked
Click the FoxyProxy icon and use the IP button at the bottom of the panel, or search for "what is my IP" in a new tab.
The address shown should be your proxy's IP address, not your own.
Send only some websites through the proxy
This is what FoxyProxy adds over the system proxy settings: everything can stay on your normal connection except the sites you choose.
In Proxies, click the orange + next to Proxy by Patterns inside your proxy.
Leave the first dropdown on Include and the second on Wildcard.
Enter a pattern, for example
*://*.example.com/*to cover a site and its subdomains.Use Exclude for a site that should never go through the proxy.
Click Save, then choose Proxy by Patterns in the toolbar panel instead of a single proxy.
The Pattern Tester tab lets you check a pattern against a URL before you rely on it.
A pattern row set to Include and Wildcard
Add many proxies at once
If you bought several proxies, you do not have to add them one by one.
Go to the Import tab and open Import Proxy List.
Paste one proxy per line in the format
ip:port:username:password. If you use IP whitelisting,ip:portis enough.Click Import, then open the Proxies tab and click Save.
Give the imported entries titles so you can tell them apart in the toolbar panel.
Import Proxy List with one proxy per line
Using the proxy in Incognito windows
Extensions are switched off in Incognito by default, so the proxy will not apply there until you allow it.
Open
chrome://extensions, click Details on FoxyProxy and turn on Allow in Incognito.
Allow in Incognito on the extension details page
Switching proxies with the keyboard
Open
chrome://extensions/shortcutsand assign a key combination to FoxyProxy.In the FoxyProxy Options tab, under Keyboard Shortcut, choose which proxy that shortcut should switch to.
Turning the proxy off
Click the FoxyProxy icon and choose Disable. Your saved proxies stay in the list for next time.
To remove a proxy completely, open Options → Proxies, click the bin icon on that proxy and then Save.
If the proxy is not working
Chrome keeps asking for a username and password: the credentials are wrong, or the proxy is set to SOCKS5 in Chrome. Switch the type to HTTP, or whitelist your IP address in your dashboard and clear the two fields.
Pages do not load at all (ERR_TUNNEL_CONNECTION_FAILED or a timeout): check the IP and port for typos, make sure the port belongs to that exact IP, and confirm the type matches the proxy you were given.
Your real IP still shows: the panel is probably set to Disable, or you are in Proxy by Patterns mode and the site does not match any pattern. Open the panel and select the proxy directly to test.
It works in a normal window but not in Incognito: turn on Allow in Incognito as described above.
Only the browser is proxied: that is expected. Other applications need the proxy set in Windows or macOS system settings, or in the application itself.
Settings stop syncing: Chrome sync storage is limited to 100 KB. With a very large proxy list FoxyProxy turns sync off automatically — your proxies stay on that computer.
You need SOCKS5 with authentication: use Firefox, where FoxyProxy supports it and also offers Proxy DNS to send DNS lookups through the proxy.
Related topics