How to Set Up a Proxy

Before you start

Get a proxy line from your dashboard in the form host:port:username:password and test it with the proxy checker. Choose HTTP unless the app requires SOCKS5.

Windows 11

1. Open Settings → Network & internet → Proxy.
2. Under Manual proxy setup, click Set up next to “Use a proxy server”.
3. Turn it on, enter the host in Proxy IP address and the port in Port, and save.
4. Open a website. Your browser will ask for the username and password.

Chrome and Edge use these Windows settings. The system setting is meant for HTTP proxies.

macOS

1. Open System Settings → Network, choose your active connection and click Details.
2. Select Proxies.
3. Turn on Web Proxy (HTTP) and Secure Web Proxy (HTTPS) or SOCKS Proxy, and enter host and port.
4. Enable Proxy server requires password and enter username and password.

Firefox (HTTP and SOCKS5)

1. Open Settings → General → Network Settings → Settings.
2. Select Manual proxy configuration.
3. Enter host and port for HTTP or for SOCKS Host with SOCKS v5.
4. For SOCKS5, tick “Proxy DNS when using SOCKS v5”, then confirm. Firefox asks for the credentials on first use.

Firefox keeps its own proxy settings, so you can use a different proxy in Firefox than in the rest of the system.

Android and iPhone

• Android: long-press your Wi-Fi network → Modify network → Advanced options → Proxy → Manual, then enter host and port. Android’s built-in setting does not accept a username and password.
• iPhone: Settings → Wi-Fi → tap the “i” next to the network → Configure Proxy → Manual, then enter host, port and turn on Authentication for username and password.

For per-app proxies, such as in Telegram, see Telegram proxies.

Command line and code

curl -x http://USERNAME:PASSWORD@HOST:PORT https://api.ipify.org
curl --proxy socks5h://USERNAME:PASSWORD@HOST:PORT https://api.ipify.org

In Python, pass proxies={"http": url, "https": url} to requests. More examples in how to use proxies.

Troubleshooting

• Wrong port or protocol: confirm whether the line is HTTP or SOCKS5.
• 407 Proxy Authentication Required: username or password is wrong, or your IP is not whitelisted.
• Timeouts: test the line in the proxy checker and try another location.
• Still seeing your own IP: the app does not use the system proxy. Set the proxy inside the app.