commit 070f57170135a9e42fa1dd70c83178552601a46c Author: emma peel <emma.peel@riseup.net> Date: Wed Feb 5 10:27:54 2020 +0100 Squashed commit of the following: commit 350a0c64564c016efe970dfd5efcd987626b010b commit c01c07d2d3e3d17ed621d5de149a0b1b540b5d43 commit 9de60260bff4e62029f5ad32c98d84a1cb52ce2f commit a4700a564e17104ae55f2a37ac3990df5a03e7cf commit a7e082adf2d7dcd92fd1875ea08b95cada615900 commit b1338ffce818b5971b7b68949bbd46653af00f8d commit e9592bfdc153f081709eabd1d392c7b95ad44773 commit ed9342f6be49aeee7062a727e450e3ae2e1c6557 commit 7b71df1efef48db1b9b37d44436fe7f20197e458 commit 0479b96c95e95ed566b50a02ae76b1e62220b1ac commit 21047b53bf1f5ee8a4a526fcd6b194de35f1b4de commit ac8c890d3fe8850e94629e595d66e9ff8cd8c817 commit c4f9dbc06cbf3677c2e7e349b40c3e509075d49c Author: Enjeck Cleopatra <32180937+PROTechThor@users.noreply.github.com> Conflicts: databags/topics.ini fixes: https://github.com/torproject/manual/pull/58/ --- assets/static/images/android-censored.png | Bin 0 -> 74940 bytes assets/static/images/android-configure.png | Bin 0 -> 69892 bytes assets/static/images/android-connect.png | Bin 0 -> 69965 bytes assets/static/images/android-new-identity.png | Bin 0 -> 105151 bytes assets/static/images/android-provide-a-bridge.png | Bin 0 -> 109572 bytes assets/static/images/android-provided-a-bridge.png | Bin 0 -> 98794 bytes assets/static/images/android-security-settings.gif | Bin 0 -> 1345090 bytes assets/static/images/android-select-a-bridge.png | Bin 0 -> 109560 bytes assets/static/images/android-selected-a-bridge.png | Bin 0 -> 124065 bytes .../images/android-uninstall-device-settings.png | Bin 0 -> 56778 bytes assets/static/images/android-uninstall-f-droid.png | Bin 0 -> 75448 bytes .../images/android-uninstall-google-play.png | Bin 0 -> 63565 bytes assets/static/images/android-update-f-droid.png | Bin 0 -> 75419 bytes .../static/images/android-update-google-play.png | Bin 0 -> 63592 bytes content/menu/contents.lr | 1 + content/mobile-tor/contents.lr | 225 +++++++++++++++++++++ databags/topics.ini | 4 + 17 files changed, 230 insertions(+) diff --git a/assets/static/images/android-censored.png b/assets/static/images/android-censored.png new file mode 100644 index 0000000..43faa8d Binary files /dev/null and b/assets/static/images/android-censored.png differ diff --git a/assets/static/images/android-configure.png b/assets/static/images/android-configure.png new file mode 100644 index 0000000..c457cca Binary files /dev/null and b/assets/static/images/android-configure.png differ diff --git a/assets/static/images/android-connect.png b/assets/static/images/android-connect.png new file mode 100644 index 0000000..8a6c1db Binary files /dev/null and b/assets/static/images/android-connect.png differ diff --git a/assets/static/images/android-new-identity.png b/assets/static/images/android-new-identity.png new file mode 100644 index 0000000..69f9f9c Binary files /dev/null and b/assets/static/images/android-new-identity.png differ diff --git a/assets/static/images/android-provide-a-bridge.png b/assets/static/images/android-provide-a-bridge.png new file mode 100644 index 0000000..5241821 Binary files /dev/null and b/assets/static/images/android-provide-a-bridge.png differ diff --git a/assets/static/images/android-provided-a-bridge.png b/assets/static/images/android-provided-a-bridge.png new file mode 100644 index 0000000..754f2cd Binary files /dev/null and b/assets/static/images/android-provided-a-bridge.png differ diff --git a/assets/static/images/android-security-settings.gif b/assets/static/images/android-security-settings.gif new file mode 100644 index 0000000..de2f796 Binary files /dev/null and b/assets/static/images/android-security-settings.gif differ diff --git a/assets/static/images/android-select-a-bridge.png b/assets/static/images/android-select-a-bridge.png new file mode 100644 index 0000000..c322898 Binary files /dev/null and b/assets/static/images/android-select-a-bridge.png differ diff --git a/assets/static/images/android-selected-a-bridge.png b/assets/static/images/android-selected-a-bridge.png new file mode 100644 index 0000000..2a1cb9d Binary files /dev/null and b/assets/static/images/android-selected-a-bridge.png differ diff --git a/assets/static/images/android-uninstall-device-settings.png b/assets/static/images/android-uninstall-device-settings.png new file mode 100644 index 0000000..0c238c0 Binary files /dev/null and b/assets/static/images/android-uninstall-device-settings.png differ diff --git a/assets/static/images/android-uninstall-f-droid.png b/assets/static/images/android-uninstall-f-droid.png new file mode 100644 index 0000000..e0342c5 Binary files /dev/null and b/assets/static/images/android-uninstall-f-droid.png differ diff --git a/assets/static/images/android-uninstall-google-play.png b/assets/static/images/android-uninstall-google-play.png new file mode 100644 index 0000000..169e2f6 Binary files /dev/null and b/assets/static/images/android-uninstall-google-play.png differ diff --git a/assets/static/images/android-update-f-droid.png b/assets/static/images/android-update-f-droid.png new file mode 100644 index 0000000..32e516d Binary files /dev/null and b/assets/static/images/android-update-f-droid.png differ diff --git a/assets/static/images/android-update-google-play.png b/assets/static/images/android-update-google-play.png new file mode 100644 index 0000000..8d96c82 Binary files /dev/null and b/assets/static/images/android-update-google-play.png differ diff --git a/content/menu/contents.lr b/content/menu/contents.lr index f10ccc0..ace6abd 100644 --- a/content/menu/contents.lr +++ b/content/menu/contents.lr @@ -32,6 +32,7 @@ Plugins Troubleshooting Uninstalling Known issues +Mobile Tor Becoming a Tor Translator Making Tor Browser portable Installation diff --git a/content/mobile-tor/contents.lr b/content/mobile-tor/contents.lr new file mode 100644 index 0000000..78fcc07 --- /dev/null +++ b/content/mobile-tor/contents.lr @@ -0,0 +1,225 @@ +_model: topic +--- +title: Mobile Tor +--- +description: Learn about Tor for mobile devices +--- +seo_slug: mobile-tor +--- +key: 15 +--- +body: + +#### Tor Browser for Android +Tor Browser for Android is the only official mobile browser supported and developed by the Tor Project. +It is like the desktop Tor Browser, but for your Android mobile device. +Some of the prime features of Tor Browser for Android include: reducing tracking across websites, defending against surveillance, resisting browser fingerprinting, and circumventing censorship. + +#### Orfox +Orfox was first released in 2015 by The Guardian Project, with the aim of giving Android users a way to browse the internet over Tor. +Over the next three years, Orfox continously improved and became a popular way for people to browse the internet with more privacy +than standard browsers, and Orfox was crucial for helping people circumvent censorship and access blocked sites and critical resources. +In 2019, [Orfox was sunsetted](https://blog.torproject.org/orfox-paved-way-tor-browser-android) after the official Tor Browser for +Android was released. + +#### Orbot +Orbot is a free proxy app that empowers other apps to use the Tor network. +Orbot uses Tor to encrypt your Internet traffic. Then you can use it with other apps installed on your mobile device to +circumvent censorship and protect against surveillance. +Orbot can be downloaded and installed from [Google Play](https://play.google.com/store/apps/details?id=org.torproject.android). +Check out [our Support portal](https://support.torproject.org/tormobile/tormobile-6/) to know if you need both Tor Browser for Android and Orbot or either one. + + +### DOWNLOADING AND INSTALLATION + +There exists Tor Browser for Android and Tor Browser for Android (alpha). +Non-technical users should get Tor Browser for Android, as this is stable and less prone to errors. +Tor Browser for Android is available on Play Store, F-droid and the Tor Project website. +It is very risky to download Tor Browser outside of these three platforms. + +#### Google Play +You can install Tor Browser for Android from [Google Play Store](https://play.google.com/store/apps/details?id=org.torproject.torbrowser). + + +#### F-Droid +The Guardian Project provides Tor Browser for Android on their F-Droid repository. +If you would prefer installing the app from F-Droid, please follow these steps: + +1. Install the F-Droid app on your Android device from [the F-droid website.](https://f-droid.org/) + +2. After installing F-Droid, open the app. + +3. At the lower-right-hand corner, open "Settings". + +4. Under the "My Apps" section, open Repositories. + +5. Toggle "Guardian Project Official Releases" as enabled. + +6. Now F-Droid downloads the list of apps from the Guardian Project's repository (Note: this may take a few minutes). + +7. Tap the Back button at the upper-left-hand corner. + +8. Open "Latest" at the lower-left-hand corner. + +10. Open the search screen by tapping the magnifying glass at the lower-right side. + +11. Search for "Tor Browser for Android". + +12. Open the query result by "The Tor Project" and install. + + +#### The Tor Project website +You can also get Tor Browser for Android by downloading and installing the apk from the [Tor Project website](https://www.torproject.org/download/#android). + + +### RUNNING TOR BROWSER FOR ANDROID FOR THE FIRST TIME + +When you run Tor Browser for the first time, you will see the option to connect directly to the Tor network, +or to configure Tor Browser for your connection with the settings icon. + +#### Connect + +<img style="max-width:300px" class="col-md-6" src="../../static/images/android-connect.png" alt="Connect to Tor Browser for Android"> + +In most cases, choosing "Connect" will allow you to connect to the Tor network without any further configuration. +Once clicked, changing sentences will appear at the bottom of the screen, indicating Tor’s connection progress. +If you are on a relatively fast connection, but this text seems to get stuck at a certain point, +see the [Troubleshooting](https://tb-manual.torproject.org/troubleshooting) page for help solving the problem. + +#### Configure + +<img style="max-width:300px" class="col-md-6" src="../../static/images/android-configure.png" alt="Configure Tor Browser for Android"> + +If you know that your connection is censored, you should select the settings icon. +Tor Browser will take you through a series of configuration options. +The first screen asks if access to the Tor network is blocked or censored on your connection. +If you know your connection is censored, or you have tried and failed to connect to the Tor network and no other solutions have worked, +click the switch. You will then be taken to the [Circumvention](/mobile-tor/#circumvention) screen to configure a pluggable transport. + +### CIRCUMVENTION + +Bridge relays are Tor relays that are not listed in the public Tor directory. +Bridges are useful for Tor users under oppressive regimes, and for people who want an extra layer of security because they're worried somebody will recognize that they are contacting a public Tor relay IP address. + +To use a pluggable transport, click on the settings icon when starting Tor Browser for the first time. +The first screen asks if access to the Tor network is censored on your connection. Click on the switch to toggle it. + +<img style="max-width:300px" class="col-md-6" src="../../static/images/android-censored.png" alt="Censored internet on Tor Browser for Android"> + +The next screen provides the option to either use a built-in bridge or custom bridge. +With the "Select a bridge" option, you will have two options: "obfs4" and "meek-azure". + +<img style="max-width:300px" class="col-md-6" src="../../static/images/android-select-a-bridge.png" alt="Select a bridge on Tor Browser for Android"> + +<img style="max-width:300px" class="col-md-6" src="../../static/images/android-selected-a-bridge.png" alt="Selected a bridge on Tor Browser for Android"> + +If you choose the "Provide a Bridge I know" option, then you have to enter a [bridge address](https://tb-manual.torproject.org/bridges/). + +<img style="max-width:300px" class="col-md-6" src="../../static/images/android-provide-a-bridge.png" alt="Provide a bridge on Tor Browser for Android"> + +<img style="max-width:300px" class="col-md-6" src="../../static/images/android-provided-a-bridge.png" alt="Provide brigde addresses on Tor Browser for Android"> + + +### MANAGING IDENTITIES + +#### New Identity + +<img style="max-width:300px" class="col-md-6" src="../../static/images/android-new-identity.png" alt="New Identity on Tor Browser for Android"> + +When Tor Browser is running, you would see so in your phone's notification panel along with the button "NEW IDENTITY". +Clicking on this button will provide you with a new identity. +Unlike in Tor Browser for Desktop, the "NEW IDENTITY" button in Tor Browser for Android does not prevent your subsequent browser activity from being linkable to what you were doing before. +Selecting it will only change your Tor circuit. + +### SECURITY SETTINGS + +<img style="max-width:300px" class="col-md-6" src="../../static/images/android-security-settings.gif" alt="Security settings and security slider on Tor Browser for Android"> + +[Security settings](https://tb-manual.torproject.org/security-settings/) disable certain web features that can be used to attack your security and anonymity. +Tor Browser for Android provides the same three security levels that are available on desktop. +You can modify the security level by following given steps: + +* Tap on a button of 3 vertical dots in URL bar. +* Scroll down and tap on "Security Settings". +* You can now select an option from the security level slider. + + +### UPDATING +Tor Browser must be kept updated at all times. If you continue to use an outdated version of the software, you may be vulnerable to serious security flaws that compromise your privacy and anonymity. +You can update Tor Browser automatically or manually. + +#### Updating Tor Browser for Android automatically +This method assumes that you have either Google Play or F-droid installed on your mobile device. + +##### Google Play + +<img style="max-width:300px" class="col-md-6" src="../../static/images/android-update-google-play.png" alt="Updating Tor Browser for Android on Google Play"> + +Click on the hamburger menu next to the search bar and navigate to "My apps & games" > "Updates". +If you find Tor Browser on the list of apps which need updating, select it and click the "Update" button. + +##### F-Droid + +<img style="max-width:300px" class="col-md-6" src="../../static/images/android-update-f-droid.png" alt="Updating Tor Browser for Android on F-droid"> + +Click on "Settings", then go to "Manage installed apps". +On the next screen, select Tor Browser and finally click on the "Update" button. + +#### Updating Tor Browser for Android manually + + +Visit the [Tor Project website](https://www.torproject.org/download/#android) and download a copy of the latest Tor Browser release, then [install](/mobile-tor/#downloading-and-installation) it as before. +In most cases, this latest version of Tor Browser will install over the older version, thereby upgrading the browser. +If doing this fails to update the browser, you may have to uninstall Tor Browser before reinstalling it. +With Tor Browser closed, remove it from your system by uninstalling it using your device's settings. +Depending on your mobile device's brand, navigate to Settings > Apps, then select Tor Browser and click on the "Uninstall" button. Afterwards,download the latest Tor Browser release and install it. + + +### UNINSTALLING +Tor Browser for Android can be uninstalled directly from F-droid, Google Play or from your mobile device's app settings. + +#### Google Play + +<img style="max-width:300px" class="col-md-6" src="../../static/images/android-uninstall-google-play.png" alt="Uninstalling Tor Browser for Android on Google Play"> + +Click on the hamburger menu next to the search bar and navigate to "My apps & games" > "Installed". +Select Tor Browser from the list of installed apps, then press the "Uninstall" button. + +#### F-Droid + +<img style="max-width:300px" class="col-md-6" src="../../static/images/android-uninstall-f-droid.png" alt="Uninstalling Tor Browser for Android on F-droid"> + +Click on "Settings", then go to "Manage installed apps". +On the next screen, select Tor Browser and finally click on the "Uninstall" button. + +#### Mobile device app settings + +<img style="max-width:300px" class="col-md-6" src="../../static/images/android-uninstall-device-settings.png" alt="Uninstalling Tor Browser for Android using device app settings"> + +Depending on your mobile device's brand, navigate to Settings > Apps, then select Tor Browser and click on the "Uninstall" button. + +### KNOWN ISSUES + +At the moment, there are some features which are not available in Tor Browser for Android, but are currently available in Tor Browser for desktop. + +* You can't see your Tor circuit. [#25764](https://trac.torproject.org/projects/tor/ticket/25764) +* Custom obfs4 bridges not working. [#30767](https://trac.torproject.org/projects/tor/ticket/30767) +* 'Clear private data' option does not clear browsing history. [#27592](https://trac.torproject.org/projects/tor/ticket/27592) +* Tor Browser for Android does not connect when moved to the SD Card. [#31814](https://trac.torproject.org/projects/tor/ticket/31814) +* You can't take screenshots while using Tor Browser for Android. [#27987](https://trac.torproject.org/projects/tor/ticket/27987) +* You can't save images. [#31013](https://trac.torproject.org/projects/tor/ticket/31013) + + +### Tor Browser for iOS +There is no Tor Browser for iOS. +We recommend an iOS app called Onion Browser, which is open source, uses Tor routing, and is developed by someone who works closely with the Tor Project. +However, Apple requires browsers on iOS to use something called Webkit, which prevents Onion Browser +from having the same privacy protections as Tor Browser. + +[Learn more about Onion Browser](https://blog.torproject.org/tor-heart-onion-browser-and-more-ios-tor). +Download Onion Browser from the [App Store](https://itunes.apple.com/us/app/onion-browser/id519296448). + + +### Tor Browser for Windows Phone +There is currently no supported method for running Tor on Windows Phone. + diff --git a/databags/topics.ini b/databags/topics.ini index 35508a9..ee6ac4b 100644 --- a/databags/topics.ini +++ b/databags/topics.ini @@ -62,6 +62,10 @@ label = Troubleshooting path = known-issues label = Known issues +[mobile-tor] +path = mobile-tor +label = Mobile Tor + [becoming-tor-translator] path = becoming-tor-translator label = Becoming a Tor Translator