Differences between revisions 1 and 27 (spanning 26 versions)
Revision 1 as of 2015-09-12 16:23:05
Size: 1974
Editor: ?SergiyKolesnikov
Comment: Init
Revision 27 as of 2017-05-03 20:23:30
Size: 10253
Editor: Francewhoa
Comment: Added link to "Debian 8 "Jessie""
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
Tor Brower protects your privacy while you are surfing the Internet: it prevents somebody watching your Internet connection from learning what sites you visit, it prevents the sites you visit from learning your physical location, and it lets you access sites which are blocked. <<TableOfContents(3)>>

= Introduction =

T
or Browser protects your privacy while you are surfing the Internet: it prevents somebody watching your Internet connection from learning what sites you visit, it prevents the sites you visit from learning your physical location, and it lets you access sites which are blocked.
Line 5: Line 9:
You have to update the browser regularly to keep your protection strong. In Debian [[DebianPkg:torbrowser-launcher|torbrowser-launcher]] is used to run Tor Browser and update it automatically.

Install torbrowser-launcher by executing the following command in the terminal as root:
{{{
To keep your protection strong you need to update the Tor Browser regularly. In Debian the easier way to do that is to install Tor Browser using [[DebianPkg:torbrowser-launcher|torbrowser-launcher]]. Which automatically install Tor Browser, run it, update it to keep its protection strong and protect your privacy.

The advantage of using the Debian package torbrowser-launcher over the official TorBrowser package is threefold:

* you will benefit from automatic upgrades
* if using AppArmor, you will benefit from the AppArmor profiles contained in the package
* you will not have to manually create launchers from your desktop or menu entries


= Install =

== Debian 9 "Stretch" ==

<!> As of May 3rd, 2017 Debian 9 "Stretch" is still in [[https://wiki.debian.org/DebianStretch|testing mode]]. So not yet stable. If you need a stable Debian, it is suggested to use the presently stable [[#Debian 8 "Jessie"|Debian 8 "Jessie"]] instead.

To install Tor Browser please choose one of the following two options:
 * '''Option 1''': [[#Debian 9 "Stretch" with Backport|Debian 9 "Stretch" with Backport]] repository
    * Note: This option includes a ''more'' recent and ''more'' secure version of Tor Browser. But ''less'' stable.

 * '''Option 2''': [[#Debian 9 "Stretch" without Backport|Debian 9 "Stretch" without Backport]] repository
    * Note: This option includes a ''less'' recent and ''less'' secure version of Tor Browser. But ''more'' stable.

If unsure, it is suggested to use the first option [[#Debian 9 "Stretch" with Backport|Debian 9 "Stretch" with Backport]]. Because it is more secure.


=== Debian 9 "Stretch" with Backport ===

Any volunteer to edit this section?


==== Frequently Ask Questions (F.A.Q.) for Debian 9 "Stretch" with Backport ====

Any volunteer to edit this section?


=== Debian 9 "Stretch" without Backport ===

Any volunteer to edit this section?


== Debian 8 "Jessie" ==

To install Tor Browser please choose one of the following two options:
 * '''Option 1''': [[#Debian 8 "Jessie" with Backport|Debian 8 "Jessie" with Backport]] repository
    * Note: This option includes a ''more'' recent and ''more'' secure version of Tor Browser. But ''less'' stable.

 * '''Option 2''': [[#Debian 8 "Jessie" without Backport|Debian 8 "Jessie" without Backport]] repository
    * Note: This option includes a ''less'' recent and ''less'' secure version of Tor Browser. But ''more'' stable.

If unsure, it is suggested to use the first option [[#Debian 8 "Jessie" with Backport|Debian 8 "Jessie" with Backport]]. Because it is more secure.


=== Debian 8 "Jessie" with Backport ===

 1. If not already done [[https://wiki.debian.org/Backports#Adding_the_repository|add the Backport repository to your sources.list]].

 1. Using Terminal as Root execute the following command
 {{{
apt-get install torbrowser-launcher -t jessie-backports
}}}

 1. To open Tor Browser choose one of the following two options
      * '''Option 1''': Using GNOME, open the Activities Search. Simply type in {{{Tor Browser}}}

      * '''Option 2''': Using Terminal as user run the following command
 {{{
torbrowser-launcher
}}}

 1. The first time you open Tor Browser the new version will automatically be downloaded and installed. On every subsequent open a check for updates will be done, and Tor Browser will automatically be updated to the latest available version from the Backport repository.


==== Frequently Ask Questions (F.A.Q.) for Debian 8 "Jessie" with Backport ====

Any volunteer to edit this section?


=== Debian 8 "Jessie" without Backport ===

 1. Using Terminal as Root execute the following command
 {{{
Line 12: Line 93:
Run the browser in GNOME by typing "Tor Browser" in the Activities Search. Run it form the terminal by enterng `torbrowser-launcher` command.

On the first start the new version of the browser will be downloaded and installed. On every subsequent run a check for updates will be done.

Good additions to the Tor Browser are the [[https://adblockplus.org/|Adblock Plus]] and [[https://www.eff.org/privacybadger|Privacy Badger]] Firefox-add-ons.

== Broken torbrowser-launcher in jessie ==

A bug (DebianBug:784041) prevents Tor Browser from running on jessie. On every start the browser is downloaded and installed, but it is never run.

There are several options for jessie users:

1. Fix the bug in the stable version of [[DebianPkg:torbrowser-launcher|torbrowser-launcher]] by running the following command in the terminal as root:
{{{
sed -i '148s_start-tor-browser_Browser/start-tor-browser_' /usr/lib/python2.7/dist-packages/torbrowser_launcher/common.py
}}}

2. Install a newer version of [[DebianPkg:torbrowser-launcher|torbrowser-launcher]] from [[http://backports.debian.org/Instructions/|jessie-backports.]]

== References ==
 1. To open Tor Browser choose one of the following two options
      * '''Option 1''': Using GNOME, open the Activities Search. Simply type in {{{Tor Browser}}}

      * '''Option 2''': Using Terminal as user run the following command
 {{{
torbrowser-launcher
}}}

 1. The first time you open Tor Browser the new version will automatically be downloaded and installed. On every subsequent open a check for updates will be done, and Tor Browser will automatically be updated to the latest available version from the Stable repository.


==== Frequently Ask Questions (F.A.Q.) for Debian 8 "Jessie" without Backport ====

Any volunteer to edit this section?


== Debian 7 "Wheezy" ==

<!> Debian 7 "Wheezy" is supported and secured until [[https://www.debian.org/News/2016/20160212|May 31st, 2018]]. With Long Term Support ([[LTS|LTS]]). To keep your computer secure it is suggested to [[https://wiki.debian.org/DebianUpgrade|upgrade to Debian 8 "Jessie"]] at your earliest convenience.

To install Tor Browser please choose one of the following two options:
 * '''Option 1''': [[#Debian 7 "Wheezy" with Backport|Debian 7 "Wheezy" with Backport]] repository
    * Note: This option includes a ''more'' recent and ''more'' secure version of Tor Browser. But ''less'' stable.

 * '''Option 2''': [[#Debian 7 "Wheezy" without Backport|Debian 7 "Wheezy" without Backport]] repository
    * Note: This option includes a ''less'' recent and ''less'' secure version of Tor Browser. But ''more'' stable.

If unsure, it is suggested to use the first option [[#Debian 7 "Wheezy" with Backport|Debian 7 "Wheezy" with Backport]]. Because it is more secure.


=== Debian 7 "Wheezy" with Backport ===

<!> Debian 7 "Wheezy" is supported and secured until [[https://www.debian.org/News/2016/20160212|May 31st, 2018]]. With Long Term Support ([[LTS|LTS]]). To keep your computer secure it is suggested to [[https://wiki.debian.org/DebianUpgrade|upgrade to Debian 8 "Jessie"]] at your earliest convenience.

 1. If not already done [[https://wiki.debian.org/Backports#Adding_the_repository|add the Backport repository to your sources.list]].

 1. Using Terminal as Root execute the following command
 {{{
apt-get install torbrowser-launcher -t wheezy-backports
}}}

 1. To open Tor Browser choose one of the following two options
      * '''Option 1''': Using GNOME, open the Activities Search. Simply type in {{{Tor Browser}}}

      * '''Option 2''': Using Terminal as user run the following command
 {{{
torbrowser-launcher
}}}

 1. The first time you run Tor Browser the new version will automatically be downloaded and installed. On every subsequent run a check for updates will be done, and Tor Browser will automatically be updated to the latest available version from the Backport repository.


==== Frequently Ask Questions (F.A.Q.) for Debian 7 "Wheezy" with Backport ====

Any volunteer to edit this section?


=== Debian 7 "Wheezy" without Backport ===

<!> Debian 7 "Wheezy" is supported and secured until [[https://www.debian.org/News/2016/20160212|May 31st, 2018]]. With Long Term Support ([[LTS|LTS]]). To keep your computer secure it is suggested to [[https://wiki.debian.org/DebianUpgrade|upgrade to Debian 8 "Jessie"]] at your earliest convenience.

Any volunteer to edit this section?


= Update =

To update choose one of the following two options. If unsure, the "automatic update" option is easier and recommended.

 * [[#Automatic_update|Automatic update]]
 * [[#Manual_update|Manual update]]


== Automatic update ==

Tor Browser will automatically prompt you to update the software once a new version has been released. The Torbutton icon will display a small yellow triangle. When you are prompted to update Tor Browser:

 1. Click on the Torbutton icon
 1. Select “Check for Tor Browser Update” option. If needed see [[https://tb-manual.torproject.org/en-US/updating.html|those screenshots]] to clarify the location.
 1. When Tor Browser has finished checking for updates, click on the “Update” button.
 1. Wait for the update to download and install, then restart Tor Browser. You will now be running the latest version.

Alternatively, if you installed Tor Browser using the `torbrowser-launcher` package. Simply close all Tor Browser windows. Then re-open Tor Browser. It will automatically check if a new version is available. Follow the instructions on your screen.


== Manual update ==

Before manually updating Tor Browser it is suggested to periodically backup any valuable data. Such as your bookmarks. Which you could import after the manual update.

Manually update Tor Browser

 1. When you are prompted to update Tor Browser, finish the browsing session and close the program.
 1. Remove Tor Browser from your system by deleting the folder that contains it. If needed see [[https://tb-manual.torproject.org/en-US/uninstalling.html|that Uninstalling section]] for more information.
 1. Visit https://www.torproject.org/projects/torbrowser.html.en and download a copy of the latest Tor Browser release, then install it as before.


= Advanced Tor Usage =
== Torrc File Location ==
=== Jessie-Backports 64 Bit ===

If you installed "torbrowser-launcher" using "jessie-backports" on 64 bit. The "torrc" advanced configuration file is located at:
 {{{
~/.local/share/torbrowser/tbb/x86_64/tor-browser_en-US/Browser/TorBrowser/Data/Tor/torrc
}}}

Related documentation
 * [[https://www.torproject.org/docs/faq.html.en#torrc|I'm supposed to "edit my torrc". What does that mean?]]


= See also =

 * Good additions to the Tor Browser are the [[https://adblockplus.org/|Adblock Plus]] and [[https://www.eff.org/privacybadger|Privacy Badger]] Firefox-add-ons.
 * [[https://blog.torproject.org/|Tor Blog]]
 * [[https://www.torproject.org/|Learn more about Tor]]
 * Alternative [[WebBrowsers]] under Debian

= References =

Introduction

Tor Browser protects your privacy while you are surfing the Internet: it prevents somebody watching your Internet connection from learning what sites you visit, it prevents the sites you visit from learning your physical location, and it lets you access sites which are blocked.

Tor Browser is based on Firefox and will be familiar to many users.

To keep your protection strong you need to update the Tor Browser regularly. In Debian the easier way to do that is to install Tor Browser using torbrowser-launcher. Which automatically install Tor Browser, run it, update it to keep its protection strong and protect your privacy.

The advantage of using the Debian package torbrowser-launcher over the official TorBrowser package is threefold:

* you will benefit from automatic upgrades * if using AppArmor, you will benefit from the AppArmor profiles contained in the package * you will not have to manually create launchers from your desktop or menu entries

Install

Debian 9 "Stretch"

<!> As of May 3rd, 2017 Debian 9 "Stretch" is still in testing mode. So not yet stable. If you need a stable Debian, it is suggested to use the presently stable Debian 8 "Jessie" instead.

To install Tor Browser please choose one of the following two options:

If unsure, it is suggested to use the first option Debian 9 "Stretch" with Backport. Because it is more secure.

Debian 9 "Stretch" with Backport

Any volunteer to edit this section?

Frequently Ask Questions (F.A.Q.) for Debian 9 "Stretch" with Backport

Any volunteer to edit this section?

Debian 9 "Stretch" without Backport

Any volunteer to edit this section?

Debian 8 "Jessie"

To install Tor Browser please choose one of the following two options:

If unsure, it is suggested to use the first option Debian 8 "Jessie" with Backport. Because it is more secure.

Debian 8 "Jessie" with Backport

  1. If not already done add the Backport repository to your sources.list.

  2. Using Terminal as Root execute the following command
    apt-get install torbrowser-launcher -t jessie-backports
  3. To open Tor Browser choose one of the following two options
    • Option 1: Using GNOME, open the Activities Search. Simply type in Tor Browser

    • Option 2: Using Terminal as user run the following command

    torbrowser-launcher
  4. The first time you open Tor Browser the new version will automatically be downloaded and installed. On every subsequent open a check for updates will be done, and Tor Browser will automatically be updated to the latest available version from the Backport repository.

Frequently Ask Questions (F.A.Q.) for Debian 8 "Jessie" with Backport

Any volunteer to edit this section?

Debian 8 "Jessie" without Backport

  1. Using Terminal as Root execute the following command
    apt-get install torbrowser-launcher
  2. To open Tor Browser choose one of the following two options
    • Option 1: Using GNOME, open the Activities Search. Simply type in Tor Browser

    • Option 2: Using Terminal as user run the following command

    torbrowser-launcher
  3. The first time you open Tor Browser the new version will automatically be downloaded and installed. On every subsequent open a check for updates will be done, and Tor Browser will automatically be updated to the latest available version from the Stable repository.

Frequently Ask Questions (F.A.Q.) for Debian 8 "Jessie" without Backport

Any volunteer to edit this section?

Debian 7 "Wheezy"

<!> Debian 7 "Wheezy" is supported and secured until May 31st, 2018. With Long Term Support (LTS). To keep your computer secure it is suggested to upgrade to Debian 8 "Jessie" at your earliest convenience.

To install Tor Browser please choose one of the following two options:

If unsure, it is suggested to use the first option Debian 7 "Wheezy" with Backport. Because it is more secure.

Debian 7 "Wheezy" with Backport

<!> Debian 7 "Wheezy" is supported and secured until May 31st, 2018. With Long Term Support (LTS). To keep your computer secure it is suggested to upgrade to Debian 8 "Jessie" at your earliest convenience.

  1. If not already done add the Backport repository to your sources.list.

  2. Using Terminal as Root execute the following command
    apt-get install torbrowser-launcher -t wheezy-backports
  3. To open Tor Browser choose one of the following two options
    • Option 1: Using GNOME, open the Activities Search. Simply type in Tor Browser

    • Option 2: Using Terminal as user run the following command

    torbrowser-launcher
  4. The first time you run Tor Browser the new version will automatically be downloaded and installed. On every subsequent run a check for updates will be done, and Tor Browser will automatically be updated to the latest available version from the Backport repository.

Frequently Ask Questions (F.A.Q.) for Debian 7 "Wheezy" with Backport

Any volunteer to edit this section?

Debian 7 "Wheezy" without Backport

<!> Debian 7 "Wheezy" is supported and secured until May 31st, 2018. With Long Term Support (LTS). To keep your computer secure it is suggested to upgrade to Debian 8 "Jessie" at your earliest convenience.

Any volunteer to edit this section?

Update

To update choose one of the following two options. If unsure, the "automatic update" option is easier and recommended.

Automatic update

Tor Browser will automatically prompt you to update the software once a new version has been released. The Torbutton icon will display a small yellow triangle. When you are prompted to update Tor Browser:

  1. Click on the Torbutton icon
  2. Select “Check for Tor Browser Update” option. If needed see those screenshots to clarify the location.

  3. When Tor Browser has finished checking for updates, click on the “Update” button.
  4. Wait for the update to download and install, then restart Tor Browser. You will now be running the latest version.

Alternatively, if you installed Tor Browser using the torbrowser-launcher package. Simply close all Tor Browser windows. Then re-open Tor Browser. It will automatically check if a new version is available. Follow the instructions on your screen.

Manual update

Before manually updating Tor Browser it is suggested to periodically backup any valuable data. Such as your bookmarks. Which you could import after the manual update.

Manually update Tor Browser

  1. When you are prompted to update Tor Browser, finish the browsing session and close the program.
  2. Remove Tor Browser from your system by deleting the folder that contains it. If needed see that Uninstalling section for more information.

  3. Visit https://www.torproject.org/projects/torbrowser.html.en and download a copy of the latest Tor Browser release, then install it as before.

Advanced Tor Usage

Torrc File Location

Jessie-Backports 64 Bit

If you installed "torbrowser-launcher" using "jessie-backports" on 64 bit. The "torrc" advanced configuration file is located at:

  • ~/.local/share/torbrowser/tbb/x86_64/tor-browser_en-US/Browser/TorBrowser/Data/Tor/torrc

Related documentation

See also

References