Start9/documentation
2
0
Fork 0
mirror of https://github.com/Start9Labs/documentation.git synced 2026-03-30 12:11:57 +00:00
Code Issues Packages Projects Releases Wiki Activity

rework tor and ff recommendations

Browse Source
This commit is contained in:
Matt Hill
2023-12-09 09:38:50 -07:00
parent 0323279a56
commit 1f7ca9d915
16 changed files with 131 additions and 136 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
site/source/user-manual/initial-setup.rst
View File

@@ -8,17 +8,9 @@ Initial Setup
Starting Fresh
--------------
#. Connect your server to power and ethernet.
#. If using Firefox to connect to your server (recommended), complete this short guide for your OS:
.. 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.
- :ref:`Mac/Windows/Linux/Android<ca-ff>`
- iOS (use Safari)
#. Connect your server to power and Ethernet
#. 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
#. From a client device (desktop/laptop/phone) connected to the same local network as your server, open a browser and visit ``http://start.local``.
.. 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".
@@ -38,21 +30,6 @@ If you are using an existing drive, transferring data from one drive to another,
Troubleshooting
---------------
If you are experiencing issues with setup, try the following:
If you followed the above instructions and are experiencing issues, click :ref:`here <setup-troubleshoot>` to resolve.
#. Confirm that the server is plugged into both power `and` Ethernet
#. Confirm your phone/computer is `not` connected to a "Guest" network
#. If using Firefox (recommended) from Mac, Windows or Android, ensure you have set ``security.enterprise_roots.enable`` to ``true`` in ``about:config`` per the :ref:`instructions<ca-ff>`
#. Confirm your phone/computer is not using a VPN, or that if you are, that it allows LAN connections, such as the examples below:
- Mullvad - Go to "Settings -> VPN Settings -> Local Network Sharing"
- ProtonVPN - Go to "Preferences -> Connection -> Allow LAN Connections"
#. Visit or refresh (ctrl+shift+R on Linux/Windows, cmd+shift+R on macOS Firefox, cmd+option+E then cmd+R on macOS Safari) the start.local page in a web browser
#. To avoid networking issues, it is recommended to use your `primary` router, not an extender or mesh router
#. Very rarely, your firewall settings may block mDNS. In this case:
- From your browser, navigate to your router configuration settings. This is usually an IP address such as 192.168.1.1. A simple web search will usually reveal how to access the router configuration settings for a particular brand.
- Once in the router config settings, find the section that lists the devices on your network. You should see a device labeled ``start``. Take note of the associated IP address and enter it into your browser's URL field to enter the setup.
You can always to `reach out to support <https://start9.com/contact>`_ if you need a hand.
You can also to `reach out to support <https://start9.com/contact>`_ if you need a hand.