Shell Mask
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

torbrowser-overlay Build Status

To add the torbrowser overlay, run layman -a torbrowser.

Install either www-client/torbrowser-launcher or www-client/torbrowser. If unsure, choose www-client/torbrowser-launcher.

Tor Browser Bundle start page



Tor Browser Launcher is intended to make Tor Browser easier to install and use for GNU/Linux users. You install 'torbrowser-launcher' from your distribution's package manager and it handles everything else:

  • Downloads and installs the most recent version of Tor Browser in your language and for your computer's architecture, or launches Tor Browser if it's already installed (Tor Browser will automatically update itself)
  • Certificate pins to, so it doesn't rely on certificate authorities
  • Verifies Tor Browser's signature for you, to ensure the version you downloaded was cryptographically signed by Tor developers and was not tampered with
  • Adds "Tor Browser" and "Tor Browser Launcher Settings" application launcher to your desktop environment's menu
  • Optionally plays a modem sound when you open Tor Browser (because Tor is so slow)


Git repository

This patched Firefox build is not recommended by Tor upstream but uses the exact same sources. Use this only if you know what you are doing!

The profile folder includes pre-configuration recommended by upstream, as well as the extensions Torbutton, NoScript and HTTPS-Everywhere. If you want to start from scratch just remove the directory ~/.mozilla/torbrowser.

Torbrowser uses port 9150 to connect to Tor. You can change the port in the connection settings to match your setup. See Preferences -> Advanced -> Network -> Connection -> SOCKS Host

Advanced torbutton functionality

To get the advanced functionality of Torbutton (network information, new identity feature), www-client/torbrowser needs to access a control port.

Tor Onion Menu

  • If you use www-client/torbrowser, you need to adjust and export the environment variables from 99torbrowser.example. You can do this either with gentoo's /etc/env.d mechanism or on the command line.

    Tor Network Settings and Check for Tor Browser Update functionality is not working with the www-client/torbrowser.

  • If you use www-client/torbrowser-launcher, make sure that the environment variables from 99torbrowser.example are unset and that you don't have the system wide tor running on port 9150.

    With www-client/torbrowser-launcher, all menu entries are available and working.