Skip to content

Latest commit

 

History

History
70 lines (45 loc) · 4.09 KB

Readme.md

File metadata and controls

70 lines (45 loc) · 4.09 KB
Raw

torbrowser-overlay gentoo qa-reports pipeline status

To add the torbrowser overlay, run eselect repository enable torbrowser.

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

Tor Browser Overview

www-client/torbrowser-launcher

Homepage

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 https://www.torproject.org, 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)

www-client/torbrowser

Git repository

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

The profile folder is located at ~/.torproject/torbrowser/.

Torbrowser uses port 9150 to connect to Tor. You can change the port in /etc/env.d/99torbrowser to match your setup. See 99torbrowser.example for possible settings. You can do this either with gentoo's /etc/env.d mechanism or on the command line.

Advanced functionality

To get the advanced functionality (network information, new identity feature, password prompts for onion services), www-client/torbrowser needs to access a control port and the tor service needs to run with certain options enabled.

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 in /etc/env.d/99torbrowser with gentoo's /etc/env.d mechanism or on the command line.

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

  • For Onion Service Authentication to work, you need to enable ExtendedErrors for the tor servic. See torrc.example . for possible settings.

Tor Hidden Service

A hidden service of this repository is available at wmj5kiic7b6kjplpbvwadnht2nh2qnkbnqtcv3dyvpqtz7ssbssftxid.onion

git -c http.proxy=socks5h://127.0.0.1:9050 clone http://wmj5kiic7b6kjplpbvwadnht2nh2qnkbnqtcv3dyvpqtz7ssbssftxid.onion/poncho/torbrowser-overlay.git
cd torbrowser-overlay
git config --add remote.origin.proxy "socks5h://127.0.0.1:9050"