This guide assumes you have completed setting up Tor. Please visit this section first before you proceed as it is required for Firefox to properly work with Tor.
Open Firefox and enter
about:config in the URL bar. Accept any warnings that may appear about accessing advanced settings.
dom.securecontext.allowlist_onions and set the value to
Download a Proxy Auto Config file to inform Firefox how to use the Tor daemon running on your computer. You can get Start9’s standard file by opening the
Terminal App on your Mac. You can find it in your list of Applications. In the terminal, enter:
brew install wget
And then:wget -P /usr/local/etc/tor https://registry.start9labs.com/sys/proxy.pac
On new (M1) Macs this directory may not exist. If so, use this command:wget -P /opt/homebrew/bin/tor https://registry.start9labs.com/sys/proxy.pac
Now, back in your Firefox web browser, select
Settings from the right-hand hamburger menu:
Search for the term “proxy” in the search bar in the upper right, then select the button that says
This should open a menu that will allow you to configure your proxy settings. Select
Automatic proxy configuration URL and paste in the path to your PAC file from earlier, prefixed with
file://. For example:
or (depending on which command you entered in step 3):file:///opt/homebrew/bin/tor/proxy.pac
Then, check the box labeled
Proxy DNS when using SOCKS v5:
OK and then restart Firefox for the changes to take effect.
You’re all set! You should now be able to navigate to
.onion URLs in Firefox. This means you can access tor-only service WebUIs, such as Cups Messenger, and use your Vaultwarden Tor address in the Bitwarden Firefox Plugin. You can test this by going to Start9’s
.onion homepage, here.