From 2a847d9472df5e517967d722db7c6f0cd1c15757 Mon Sep 17 00:00:00 2001 From: Matt Hill Date: Sun, 19 Nov 2023 11:24:59 -0700 Subject: [PATCH] clean up --- site/source/device-guides/android/ca-android.rst | 6 ++++-- site/source/device-guides/android/tor-android.rst | 8 +++++--- site/source/device-guides/ios/ca-ios.rst | 2 +- site/source/device-guides/linux/ca-linux.rst | 6 +++--- site/source/device-guides/mac/ca-mac.rst | 2 +- site/source/device-guides/windows/ca-windows.rst | 4 ++-- site/source/misc-guides/ca-ff.rst | 2 +- site/source/user-manual/initial-setup.rst | 8 ++++---- 8 files changed, 21 insertions(+), 17 deletions(-) diff --git a/site/source/device-guides/android/ca-android.rst b/site/source/device-guides/android/ca-android.rst index 0ebd706..3a2ce54 100644 --- a/site/source/device-guides/android/ca-android.rst +++ b/site/source/device-guides/android/ca-android.rst @@ -5,9 +5,11 @@ Trusting Your Root CA on Android ================================ Complete this guide to trust your server's Root Certificate Authority (Root CA) on Android. -.. note:: This guide only applies to Android phones running Android v13+, as well as phones running CalyxOS, GrapheneOS, or LineageOS (v19+). +.. warning:: You must use `Firefox Beta `_ on Android. The regular Firefox app will not work. -#. Ensure you have already :ref:`downloaded your Root CA ` +.. warning:: This guide only applies to Android phones running Android v13+, as well as phones running CalyxOS, GrapheneOS, or LineageOS (v19+). + +#. Ensure you have :ref:`downloaded your Root CA ` #. Tap **Settings > Security > More security settings > Encryption & credentials > Install a certificate > CA Certificate > Install Anyway** and select your custom-named ``adjective-noun.local.crt`` certificate. diff --git a/site/source/device-guides/android/tor-android.rst b/site/source/device-guides/android/tor-android.rst index c2512f4..d7c4318 100644 --- a/site/source/device-guides/android/tor-android.rst +++ b/site/source/device-guides/android/tor-android.rst @@ -1,10 +1,12 @@ .. _tor-android: -==================== -Using Tor on Android -==================== +====================== +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. +.. warning:: You must use `Firefox Beta `_ on Android. The regular Firefox app will not work. + Running Orbot ------------- Orbot is a system-wide proxy for your Android device that enables communications over Tor. diff --git a/site/source/device-guides/ios/ca-ios.rst b/site/source/device-guides/ios/ca-ios.rst index ec2f2af..e51caf2 100644 --- a/site/source/device-guides/ios/ca-ios.rst +++ b/site/source/device-guides/ios/ca-ios.rst @@ -5,7 +5,7 @@ Trusting Your Server's Root CA on iOS ===================================== Complete this guide to trust your server's Root Certificate Authority (Root CA) on iOS. -#. Ensure you have already :ref:`downloaded your Root CA ` +#. Ensure you have :ref:`downloaded your Root CA ` #. Open your iCloud Downloads folder and click on the certificate. It will display a dialog box that says "Profile Downloaded." Click `Close`. diff --git a/site/source/device-guides/linux/ca-linux.rst b/site/source/device-guides/linux/ca-linux.rst index 2e682d4..69607ca 100644 --- a/site/source/device-guides/linux/ca-linux.rst +++ b/site/source/device-guides/linux/ca-linux.rst @@ -12,7 +12,7 @@ Trusting Your Root CA on Linux These instructions will work for most Debian-based Linux distributions, such as Debian, Linux Mint, PopOS, Ubuntu, etc. - #. Ensure you have already :ref:`downloaded your Root CA ` + #. Ensure you have :ref:`downloaded your Root CA ` #. Perform the following commands in the Terminal: @@ -39,7 +39,7 @@ Trusting Your Root CA on Linux .. group-tab:: Arch/Garuda - #. Ensure you have already :ref:`downloaded your Root CA ` + #. Ensure you have :ref:`downloaded your Root CA ` #. From the folder you have downloaded your Start9 server's Root CA, run the following commands. Take care to replace `adjective-noun` with your server's unique adjective-noun combination in the command below. If you have changed the certificate's filename, be sure to change it here. @@ -53,7 +53,7 @@ Trusting Your Root CA on Linux .. group-tab:: CentOS/Fedora - #. Ensure you have already :ref:`downloaded your Root CA ` + #. Ensure you have :ref:`downloaded your Root CA ` #. In `/etc/systemd/resolved.conf`, ensure you have ``MulticastDNS=Yes`` diff --git a/site/source/device-guides/mac/ca-mac.rst b/site/source/device-guides/mac/ca-mac.rst index 8721820..41fc5a5 100644 --- a/site/source/device-guides/mac/ca-mac.rst +++ b/site/source/device-guides/mac/ca-mac.rst @@ -5,7 +5,7 @@ Trusting Your Root CA on Mac ============================ Complete this guide to trust your server's Root Certificate Authority (Root CA) on Mac. -#. Ensure you have already :ref:`downloaded your Root CA ` +#. Ensure you have :ref:`downloaded your Root CA ` #. Locate your downloaded Root CA. Right click it and select *Show in Folder*: diff --git a/site/source/device-guides/windows/ca-windows.rst b/site/source/device-guides/windows/ca-windows.rst index 43c0e5d..8f0fb55 100644 --- a/site/source/device-guides/windows/ca-windows.rst +++ b/site/source/device-guides/windows/ca-windows.rst @@ -5,9 +5,9 @@ Trusting Your Root CA on Windows ================================ Complete this guide to trust your server's Root Certificate Authority (Root CA) on Windows. -#. Ensure you have already :ref:`downloaded your Root CA ` +#. Ensure you have :ref:`downloaded your Root CA ` -#. Ensure you have already :ref:`installed bonjour ` +#. Ensure you have :ref:`installed bonjour ` #. Click the “Start” menu, type “mmc”, and select "Run as administrator" to access the Windows Management Console. diff --git a/site/source/misc-guides/ca-ff.rst b/site/source/misc-guides/ca-ff.rst index 02b1537..e4fe1f6 100644 --- a/site/source/misc-guides/ca-ff.rst +++ b/site/source/misc-guides/ca-ff.rst @@ -56,7 +56,7 @@ Configuring Firefox to Respect Your Root CA .. group-tab:: Android - .. note:: You must use Firefox Beta on Android. The regular Firefox app will not work. + .. warning:: You must use `Firefox Beta `_ on Android. The regular Firefox app will not work. #. Tap ``Kebab Menu > Settings > About Firefox`` and tap the Firefox icon 5 times to enable "developer mode" diff --git a/site/source/user-manual/initial-setup.rst b/site/source/user-manual/initial-setup.rst index 4db6d29..f961e96 100644 --- a/site/source/user-manual/initial-setup.rst +++ b/site/source/user-manual/initial-setup.rst @@ -9,16 +9,16 @@ Initial Setup Starting Fresh -------------- -#. Prepare your client device. If using Firefox (recommended), complete this short guide for your OS: +#. If using Firefox to connect to your server (recommended), complete this short guide for your OS: - .. note:: Firefox is the only browser that can be configured to access both LAN (`.local`) and Tor (`.onion`) URLs, including extensions, without affecting normal browser functionality. For iOS, all browsers actually use Safari under the hood, so it is preferable not to stack unnecessary software on top of it. Just use Safari. + .. note:: Start9 recommends Firefox because it is the only browser that can be configured to access both LAN (`.local`) and Tor (`.onion`) URLs, including through browser extensions, without affecting normal browser functionality. For iOS, all browsers actually use Safari under the hood, so it is preferable not to stack unnecessary software on top of it. Just use Safari. - - Mac/Windows/Linux/Android :ref:`Linux ` + - :ref:`Mac/Windows/Linux/Android` - iOS (use Safari) #. Connect your server to power and Ethernet -#. From a client device (desktop/laptop/phone), open a browser (Firefox recommended) and visit ``http://start.local``. Your client device must be connected to the same Local Area Network (LAN) as your server. This usually means they are using the same router, either by ethernet or WiFi +#. From your client device (desktop/laptop/phone), open a browser (Firefox recommended) and visit ``http://start.local``. Your client device must be connected to the same Local Area Network (LAN) as your server. This usually means they are using the same router, either by ethernet or WiFi .. note:: If you are `not` using a Raspberry Pi, you can also plug a monitor and keyboard into the server. This is known as "Kiosk mode".