diff --git a/site/source/_static/images/tor/tor-android-orbot-connecting.jpeg b/site/source/_static/images/tor/tor-android-orbot-connecting.jpeg new file mode 100644 index 0000000..9238212 Binary files /dev/null and b/site/source/_static/images/tor/tor-android-orbot-connecting.jpeg differ diff --git a/site/source/_static/images/tor/tor-android-orbot-proxy-mode.png b/site/source/_static/images/tor/tor-android-orbot-proxy-mode.png new file mode 100644 index 0000000..4a1b9ef Binary files /dev/null and b/site/source/_static/images/tor/tor-android-orbot-proxy-mode.png differ diff --git a/site/source/_static/images/tor/tor-android-orbot-settings-menu.png b/site/source/_static/images/tor/tor-android-orbot-settings-menu.png new file mode 100644 index 0000000..3177e10 Binary files /dev/null and b/site/source/_static/images/tor/tor-android-orbot-settings-menu.png differ diff --git a/site/source/_static/images/tor/tor-android-orbot-vpn-choose-apps.jpeg b/site/source/_static/images/tor/tor-android-orbot-vpn-choose-apps.jpeg new file mode 100644 index 0000000..28f6c7a Binary files /dev/null and b/site/source/_static/images/tor/tor-android-orbot-vpn-choose-apps.jpeg differ diff --git a/site/source/_static/images/tor/tor-android-orbot-vpn-mode.png b/site/source/_static/images/tor/tor-android-orbot-vpn-mode.png new file mode 100644 index 0000000..622062a Binary files /dev/null and b/site/source/_static/images/tor/tor-android-orbot-vpn-mode.png differ diff --git a/site/source/_static/images/tor/tor-android-orbot-vpn-off.jpeg b/site/source/_static/images/tor/tor-android-orbot-vpn-off.jpeg new file mode 100644 index 0000000..671dd78 Binary files /dev/null and b/site/source/_static/images/tor/tor-android-orbot-vpn-off.jpeg differ diff --git a/site/source/_static/images/tor/tor-android-orbot-vpn-on.jpeg b/site/source/_static/images/tor/tor-android-orbot-vpn-on.jpeg new file mode 100644 index 0000000..0a1aea6 Binary files /dev/null and b/site/source/_static/images/tor/tor-android-orbot-vpn-on.jpeg differ diff --git a/site/source/_static/images/tor/tor-android-orbot-vpn-settings.jpeg b/site/source/_static/images/tor/tor-android-orbot-vpn-settings.jpeg new file mode 100644 index 0000000..8ec3e83 Binary files /dev/null and b/site/source/_static/images/tor/tor-android-orbot-vpn-settings.jpeg differ diff --git a/site/source/device-guides/android/tor-android.rst b/site/source/device-guides/android/tor-android.rst index d9889b9..01e93d0 100644 --- a/site/source/device-guides/android/tor-android.rst +++ b/site/source/device-guides/android/tor-android.rst @@ -5,56 +5,65 @@ Running Tor on Android ====================== Some apps, such as the official Tor Browser, have Tor built in. They do not require additional software or configurations to utilize Tor. Most apps, however, do not have Tor built in. They require an app called Orbot to be installed in order to utilize the Tor Network. -Running Orbot + +Install Orbot ------------- #. Download and install Orbot from the `Play Store `_, or from `F-Droid `_ (must open with F-Droid app). Then launch the app. .. note:: When using F-Droid, you will need to activate the Guardian Project repository by visiting the ``Settings`` menu (bottom right) -> ``Repositories`` -> ``Guardian Project Official Releases`` - .. figure:: /_static/images/tor/orbot0.png - :width: 20 % - :alt: Orbot - -#. Tap "Start VPN". +Running Orbot in "Power User Mode" and initial configuration +------------------------------------------------------------ - .. figure:: /_static/images/tor/orbot1.png - :width: 20 % - :alt: Orbot starting +This configuration allows you to run Tor `in the background` listening for just ``.onion`` addresses. Anything that isn't an ``.onion`` address will be treated normally and not go through the Tor network. -#. Orbot will start up the Tor service. Once complete, you will see: + .. note:: Some Android apps won't work on this setting and will need Orbot to be run in VPN mode. There is more on this in the next section, but it's useful to know how to toggle between the two modes so that when not using Tor services you can continue to access the internet at ordinary speeds. This setting is ideal for using :ref:`Firefox Beta configured as per this guide` and for those who have another VPN activated at the same time. + - .. figure:: /_static/images/tor/orbot2.png - :width: 20 % - :alt: Orbot running +#. Tap `More` in the bottom right hand corner and select `Settings`: -#. Open the kebab menu in the bottom right hand corner and select `Settings`: + .. figure:: /_static/images/tor/tor-android-orbot-settings-menu.png + :width: 70 % + :alt: Tap on More - .. figure:: /_static/images/tor/orbot_menu.png - :width: 20 % - :alt: Orbot settings #. Make sure the options for `Start Orbot on Boot` and `Allow Background Starts` are checked: - .. figure:: /_static/images/tor/orbot_settings.png - :width: 20 % + .. figure:: /_static/images/tor/tor-android-orbot-vpn-off.jpeg + :width: 40 % :alt: Orbot menu -#. That's it, you're now running a Tor client on your Android device! Certain apps, such as Firefox, Fennec, and DuckDuckGo will now work after you configure them to use Tor's local proxy. Other apps do not have sophisticated proxy configurations and require that Orbot be running in VPN mode. +#. And then also check `Power User Mode`. + + .. note:: This is what you'll uncheck, check and uncheck again to switch between `VPN mode` and `Power User Mode` as you need to. + + .. figure:: /_static/images/tor/tor-android-orbot-proxy-mode.png + :width: 80% + :alt: Orbot connecting and running + + +That's it, you're now running a Tor client on your Android device! Certain apps, such as Firefox, Fennec, and DuckDuckGo will now work after you configure them to use Tor's local proxy. Other apps do not have sophisticated proxy configurations and require that Orbot be running in VPN mode. Orbot VPN mode -------------- -To utilize Tor, some apps require that Orbot be running in VPN mode. This means that you are sending your application's traffic across the Tor network via Orbot. +To utilize Tor, some apps require that Orbot be running in VPN mode. This means that you are sending your application's traffic across the Tor network via Orbot (and all other traffic too). #. Disable Private DNS on your device. Navigate to: ``Settings > Network & Internet > Advanced > Private DNS > Off`` and toggle Private DNS to "off". .. figure:: /_static/images/tor/private_dns_off.png - :width: 20% + :width: 40% :alt: Private DNS off -#. Tap `Select Apps`, and add the apps you want to utilize Tor. +#. Make sure the option for `Power User Mode` is unchecked: - .. figure:: /_static/images/tor/orbot_apps.png - :width: 20% + .. figure:: /_static/images/tor/tor-android-orbot-vpn-on.jpeg + :width: 40 % + :alt: Orbot menu + +#. Tap `Choose Apps`, and add the apps you want to utilize Tor. + + .. figure:: /_static/images/tor/tor-android-orbot-vpn-choose-apps.jpeg + :width: 40% :alt: Orbot apps Examples of applications that need this feature for remote access are: @@ -62,10 +71,11 @@ Examples of applications that need this feature for remote access are: - Bitwarden - Element (Matrix client) - Nextcloud +- SimpleX - .. figure:: /_static/images/tor/orbot2.png - :width: 20% - :alt: Orbot running + .. figure:: /_static/images/tor/tor-android-orbot-vpn-mode.png + :width: 80% + :alt: Orbot connecting and running in VPN mode You can also add the following browsers to the Tor-Enabled Apps list to easily access Tor addresses (`.onion` URLs):