sodcalculator

10 Tech How-To

How to Set or Change Proxy Settings in Firefox

Guide 10-49643 · Updated · Step by step

This guide shows you how to configure or change proxy settings in Firefox, whether you need to route traffic through a corporate proxy, a VPN, or a local debugging tool. You’ll learn where the settings live, how to enter different types of proxies, and how to fix common issues. No special tools are needed—just Firefox itself.

What You’ll Need

  • Firefox installed on your computer (Windows, macOS, or Linux).
  • The proxy server address and port number. If you don’t have one, you can use a public proxy or set up a local one (like Fiddler or mitmproxy) for testing.
  • If the proxy requires authentication, have the username and password ready.

Step-by-Step

  1. Open Firefox Settings. Click the menu button (three horizontal lines) in the top-right corner, then select Settings (or Options on some systems).
  2. Navigate to Network Settings. In the left sidebar, click General. Scroll down to the Network Settings section at the bottom of the page.
  3. Open the Connection Settings dialog. Click the Settings… button next to “Configure how Firefox connects to the internet.” A pop-up window appears.
  4. Choose your proxy configuration mode. You have five options:
    • No proxy – Firefox connects directly, ignoring any system proxy.
    • Auto-detect proxy settings for this network – Firefox uses WPAD to find a proxy automatically (rarely needed).
    • Use system proxy settings – Firefox uses the proxy configured in your operating system (default).
    • Manual proxy configuration – You enter proxy details yourself.
    • Automatic proxy configuration URL – You provide a .pac file URL that defines proxy rules.
  5. Enter manual proxy details (if chosen). For HTTP, HTTPS, and FTP proxies, type the hostname or IP address in the corresponding field and the port number in the “Port” field. For SOCKS, check the “SOCKS v5” box (or leave v4 if your proxy requires it) and enter the host and port. You can also check “Proxy DNS when using SOCKS v5” to route DNS lookups through the proxy (useful for privacy or when the proxy needs to resolve domain names).
  6. Set exceptions (optional). In the “No Proxy for” field, list addresses that should bypass the proxy, separated by commas. Use *.example.com for a domain and its subdomains, or localhost for local access. A common value is localhost, 127.0.0.1.
  7. Save your settings. Click OK to close the dialog, then close the Settings tab. Your changes take effect immediately—no restart needed.
  8. Verify the proxy works. Visit a website like whatismyip.com to see if your IP address matches the proxy’s IP. If you set an HTTP proxy, the site should show the proxy’s IP, not your real one.

Common Mistakes

  • Mixing up HTTP and SOCKS proxies. HTTP proxies are for web traffic; SOCKS proxies handle any TCP/UDP traffic. Using the wrong type may cause connection errors.
  • Forgetting the port number. Most proxies use specific ports (e.g., 8080 for HTTP, 1080 for SOCKS). Entering the host without the port will fail.
  • Leaving “No Proxy” blank when you need local access. If you’re debugging a local server, add localhost to the exception list, otherwise Firefox will try to route it through the proxy and fail.
  • Using “Auto-detect” when you have a manual proxy. This can cause Firefox to ignore your manual settings and use a wrong proxy (or none).
  • Not checking the “Proxy DNS when using SOCKS v5” option. Without it, DNS requests may go directly, leaking your real DNS queries even though traffic is proxied.

Tips

  • To quickly switch between proxies, use a browser extension like FoxyProxy (but this guide focuses on built-in settings).
  • If you’re using a corporate proxy, ask your IT department for the exact host, port, and authentication method (often NTLM or Kerberos).
  • For a temporary proxy, you can use the command line: firefox -CreateProfile and then set proxy per profile, but that’s more advanced.
  • Test your proxy with a simple HTTP site first, then HTTPS. Some proxies handle HTTP but not HTTPS (or vice versa).
  • If you’re using a PAC file, make sure the URL is accessible without the proxy (e.g., on a local network).

Troubleshooting

Proxy connection refused. Check that the proxy server is running and reachable. Try pinging the host or using a telnet client to test the port. If it’s a local proxy, ensure it’s listening on the correct interface (not just 127.0.0.1).

Websites don’t load after setting proxy. This usually means the proxy is down or the settings are wrong. Double-check the host and port. If you’re using a PAC file, verify the URL is correct and the file is valid (open it in a browser).

Authentication errors. If the proxy requires a username/password, Firefox will prompt you. If you see an error like “407 Proxy Authentication Required,” re-enter your credentials. Some proxies use NTLM, which Firefox supports, but you may need to enable network.negotiate-auth.allow-proxies in about:config (set to true).

Firefox ignores system proxy settings. If you selected “Use system proxy settings” but it’s not working, check your OS proxy settings. On Windows, go to Settings > Network & Internet > Proxy. On macOS, System Preferences > Network > Advanced > Proxies. Make sure the system proxy is actually enabled.

Proxy works but HTTPS sites fail. This can happen if the proxy does not support the CONNECT method for HTTPS. Try a different proxy or check with the proxy provider. Also, ensure Firefox is not set to use a proxy for HTTPS that doesn’t support it.

Settings revert after restart. This is rare, but if it happens, check if Firefox is configured to use a policy (e.g., via Group Policy on Windows). If not, try resetting Firefox preferences by going to about:support and clicking “Refresh Firefox.”

Frequently Asked Questions

Q: How do I find my proxy server address?
A: If you’re at work, ask your IT admin. If you’re using a public proxy, find one online (but be cautious—public proxies can be insecure). You can also run a local proxy like mitmproxy, which listens on 127.0.0.1:8080 by default.

Q: Can I use a proxy for only some websites?
A: Yes, use the “No Proxy for” field to list domains that should bypass the proxy. For more complex rules, use a PAC file or an extension like FoxyProxy.

Q: Does Firefox use the system proxy by default?
A: Yes, the default setting is “Use system proxy settings.” If you change it, you can revert by selecting that option again.

Q: Why does my proxy work in Chrome but not Firefox?
A: Chrome uses the system proxy by default, while Firefox has its own settings. If you set a proxy in Firefox manually, it overrides the system. Check that Firefox is set to “Use system proxy settings” or enter the same proxy details manually.

Q: What is a PAC file and do I need one?
A: A PAC file is a JavaScript file that tells the browser which proxy to use for different URLs. You only need one if your network requires it (e.g., a corporate environment). If you have a single proxy, manual configuration is simpler.

Q: How do I reset Firefox proxy settings to default?
A: Go to Settings > General > Network Settings, click “Settings…”, and choose “Use system proxy settings.” If that doesn’t work, go to about:support and click “Refresh Firefox” to reset all settings (but this will also clear your extensions and customizations).

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →