All Collections
Set Up
Mac Set Up
Freedom and Local Software Development Environments on Mac
Freedom and Local Software Development Environments on Mac

This article provides tips for making sure that Freedom and your Local Software Development Environment work together.

Freedom avatar
Written by Freedom
Updated over a week ago

Here are some helpful suggestions to ensure that Freedom and your software development environment work properly side-by-side.

Technical information

On the desktop, Freedom utilizes a local proxy to filter the content you've selected. We use this approach because it gives us a good balance of speed, flexibility (wildcard support, etc.), and privacy protection (does not require elevated permissions, and blocking is completely contained to the machine). The Freedom proxy runs on port 7769, and uses compiled regular expressions for real-time pass/no-pass decisions.

Proxy Interactions with Development Environments

The primary issue we see with local development environments is an incompatibility with local proxy. That is, a local development tool is unable to, or unhappy with running through the proxy. Generally, these issues can be resolved by enabling the tool to run through a proxy (sometimes a command flag) or by bypassing the local proxy.

Local Proxy Bypass

You can specify IP ranges and hostnames to exclude from the Mac proxy via Preferences -> Network -> Advance -> Proxies -> Bypass settings for these Hosts & Domains. You'll want to make sure that the address or hostname of your local server is on that list (it could be,, localhost,, etc.) This field supports wildcards for IP ranges. Apple Support Article.

Interactions with Specific Products

Some specific solutions for interactions with development tools. If you've run into an issue with Freedom and a development tool, please let us know so we can attempt to identify a solution.

VPN Services

It is fairly commonplace for developers to use a VPN service for traffic testing, etc. If you are using a browser-based VPN, please install our Freedom browser extensions to ensure that Freedom can continue to block websites as intended.

Did this answer your question?