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

Maint/misc fixes 2023 (#418)

Browse Source 
* Fix broken contact links

* Remove bad sentence

* Mac guide fixes and x86_64 flashing update

* Remove dated tor video, fix more links

* Update site/source/user-manual/connecting/connecting-tor/tor-os/tor-mac.rst

Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com>

* Update site/source/user-manual/flashing/flashing-pi.rst

Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com>

---------

Co-authored-by: gStart9 <106188942+gStart9@users.noreply.github.com>
This commit is contained in:
kn0wmad
2023-06-26 22:25:54 +00:00
committed by GitHub
parent a82807c0ca
commit 5d115e4ef4
13 changed files with 18 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
site/source/developer-docs/packaging.rst
View File

@@ -429,7 +429,7 @@ Check out the specification `here <https://start9.com/latest/developer-docs/spec
Support
=======
Have a question? Need a hand? Please jump into our `Community <https://community.start9.com>`_, or our `Matrix Community Dev Channel <https://matrix.to/#/#community-dev:matrix.start9labs.com>`_. You can also check out our full list of :ref:`Community Channels <contact>`.
Have a question? Need a hand? Please jump into our `Community <https://community.start9.com>`_, or our `Matrix Community Dev Channel <https://matrix.to/#/#community-dev:matrix.start9labs.com>`_. You can also check out our full list of `Community Channels <https://start9.com/contact>`_.
Need more details? Check out the :ref:`Service Packaging Specification <service-packaging-spec>`

5
site/source/learn/concepts/start9-startos.rst
View File

@@ -28,8 +28,7 @@ StartOS
-------
StartOS is a Linux-based operating system built to simplify open source software hosting. It has a range of features that allow anyone to run their own server software without needing all of the traditionally required systems administration skills. Features such as advanced dependency management, sensible default configuration with potential for customization, and a sleek GUI make for a smooth user experience with minimal reliance on the developers for people with all levels of technical expertise.
Start9 currently supports the Raspberry Pi, and most x86_64 and ARM hardware architectures. Our wonderful community is constantly adding to the list of `known good hardware <https://community.start9.com/t/known-good-hardware-master-list-hardware-capable-of-running-startos/66>_` and we hope to add official support for more platforms soon! Drop in our :ref:`community channels<contact>` to learn more and collaborate!!
Start9 currently supports the Raspberry Pi, and most x86_64 and ARM hardware architectures. Our wonderful community is constantly adding to the list of `known good hardware <https://community.start9.com/t/known-good-hardware-master-list-hardware-capable-of-running-startos/66>_` and we hope to add official support for more platforms soon! Drop in our `community channels <https://start9.com/contact>`_ to learn more and collaborate!!
.. _sounds:
@@ -71,7 +70,7 @@ On some models (Server Lite, 2022 Server One, and Server Pure), StartOS emits so
Your browser does not support the audio element.
</audio>
* "Beethoven" - An error has occurred. Check your "Notifications" tab for more info, or `Contact Support <https://start9.com/contact>_`
* "Beethoven" - An error has occurred. Check your "Notifications" tab for more info, or `Contact Support <https://start9.com/contact>`_
.. _services-eos:

2
site/source/support/common-issues.rst
View File

@@ -13,7 +13,7 @@ Sometimes things don't go as planned. Check here for solutions to common problem
StartOS will not boot
---------------------
If the device will not power on at all (no lights whatsoever), then the only issues could be that the Pi is not getting the power it needs, or it is completely dead (extremely rare). If you sourced your own parts, please ensure that the power supply meets the minimum required specifications in the :ref:`DIY Guide<diy>`. If you received your device from us and it will not power up at all, please `Contact us <https://start9.com/contact>_` for assistance.
If the device will not power on at all (no lights whatsoever), then the only issues could be that the Pi is not getting the power it needs, or it is completely dead (extremely rare). If you sourced your own parts, please ensure that the power supply meets the minimum required specifications in the :ref:`DIY Guide<diy>`. If you received your device from us and it will not power up at all, please `Contact us <https://start9.com/contact>`_ for assistance.
StartOS boots into "Diagnostic Mode"
------------------------------------

2
site/source/support/faq/faq-basic-use.rst
View File

@@ -85,7 +85,7 @@ Why would I even buy this when I can just build it for free?
Bottom line...We are charging a very marginal rate for something incredibly powerful, and we think the convenience of a plug-and-play device, free service marketplace, and free white glove support is where the money is. Anyone could build their own couches too, but here is a reason furniture stores exist. How much is your time worth?
The fastest way to get support is via our `Community channels <https://start9.com/contact>_`. Please do not hesitate to reach out!
The fastest way to get support is via our `Community channels <https://start9.com/contact>`_. Please do not hesitate to reach out!
I bought a server from Start9 before Q3 2022 and it came with a 'product key,' what is that?
--------------------------------------------------------------------------------------------

2
site/source/support/faq/faq-contributing.rst
View File

@@ -19,4 +19,4 @@ Do I need to be a professional developer or have coding experience to contribute
---------------------------------------------------------------------------------
Absolutely not! Contributions can be as simple as finding a typo in our docs, making a suggestion on GitHub, creating educational or promotional content, and the list goes on! Everyone that wants to contribute can do so in some unique way.
First check our `Contributing <https://start9.com/contribute>`_ page and please don't hesitate to `Contact <https://start9.com/contact>_` us for ideas if you're not sure where to begin.
First check our `Contributing <https://start9.com/contribute>`_ page and please don't hesitate to `Contact <https://start9.com/contact>`_ us for ideas if you're not sure where to begin.

2
site/source/support/faq/faq-general.rst
View File

@@ -96,7 +96,7 @@ Yes! The full warranty for a device purchased from us is located on the insert i
What kind of Internet connection does a server require?
-------------------------------------------------------
In general, any modern Internet connection is usually fine. We have had reports from users on rural satellite connections with high latency (ping), and low up/download speeds who had issues accessing via Tor. You can check your internet connection at `SpeedTest <https://speedtest.net>`_ to find your ping and speed. If your ping is higher than 200ms and/or your speeds are lower than 5Mbps, you may want to locate your server somewhere with a better connection. Please don't hesitate to `contact us <https://start9.com/contact>_` with any questions.
In general, any modern Internet connection is usually fine. We have had reports from users on rural satellite connections with high latency (ping), and low up/download speeds who had issues accessing via Tor. You can check your internet connection at `SpeedTest <https://speedtest.net>`_ to find your ping and speed. If your ping is higher than 200ms and/or your speeds are lower than 5Mbps, you may want to locate your server somewhere with a better connection. Please don't hesitate to `contact us <https://start9.com/contact>`_ with any questions.
I run a business, can I use StartOS for tasks such as password management and file sharing?
-------------------------------------------------------------------------------------------

2
site/source/support/faq/faq-troubleshooting.rst
View File

@@ -58,7 +58,7 @@ Nothing special is required, however, it is best practice to use good passwords,
What if I have an unique network issue, for example, with a firewall?
---------------------------------------------------------------------
StartOS is designed to work as simply as possible, for as many as possible, while providing the ability to host in a private manner. If you have an aggressive or custom firewall, or other custom network settings, there is a good chance that addtional configuration may be necessary. We will continue to learn about custom networking issues, update our docs with resources, and help in the `Community Channels <https://start9.com/contact>_` to the best of our ability.
StartOS is designed to work as simply as possible, for as many as possible, while providing the ability to host in a private manner. If you have an aggressive or custom firewall, or other custom network settings, there is a good chance that addtional configuration may be necessary. We will continue to learn about custom networking issues, update our docs with resources, and help in the `Community Channels <https://start9.com/contact>`_ to the best of our ability.
Can I use my server from behind a VPN, for example, if my router has a built-in VPN?
------------------------------------------------------------------------------------

8
site/source/user-manual/backups/backup-setup/backup-mac.rst
View File

@@ -57,9 +57,9 @@ Please select what version of MacOS you are using from the two tabs below:
:width: 40%
:alt: ventura-smb
You can now move on to connecting your server.
#. Click **Done** to close this window. You can now move on to connecting your server.
.. tip:: You can find hostname at the bottom of sharing window.
.. tip:: You can find hostname at the bottom of sharing window. You will need this in the next step.
.. group-tab:: Pre-Ventura
@@ -131,14 +131,12 @@ Connect Your Server
* **Hostname** - This is the name of your computer.
.. tip:: Sometimes it can be unclear what your Mac's hostname is. One way to establish it for good is to open up Terminal and type `hostname` as below:
.. tip:: Sometimes it can be unclear what your Mac's hostname is. Check the tip in Step 8 of the section above to find it. On some versions of Mac, you may need to open up Terminal and type `hostname` as below:
.. figure:: /_static/images/cifs/hostname-terminal-mac.png
:width: 35%
:alt: hostname-terminal-mac
In Pre-Ventura versions of MacOS it can be found in the **Sharing** settings mentioned above (step 7).
* **Path** - This is the *name of the shared folder* you are using and **not** the full directory path.
.. tip:: If you copied the share name from the Mac computer and it contained a space, macOS will have replaced the space with the string "%20". Please re-replace `%20` with a space in this `Path` field.

3
site/source/user-manual/connecting/connecting-tor/tor-os/tor-android.rst
View File

@@ -6,9 +6,6 @@ Running Tor on Android
Some apps, such as :ref:`Tor Browser<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.
.. youtube:: b__mVfN-BP8
:width: 100%
Running Orbot
-------------

2
site/source/user-manual/connecting/connecting-tor/tor-os/tor-mac.rst
View File

@@ -98,7 +98,7 @@ Enable Tor System-wide
:width: 80%
:alt: Click Advanced
#. Select "Automatic Proxy Configuration", add this URL: **http://localhost/proxy.pac** then click "OK":
#. Click "Proxies," then select "Automatic Proxy Configuration," add this URL: ``http://localhost/proxy.pac``, then click "OK":
.. figure:: /_static/images/tor/ventura-proxies-corrected.png
:width: 80%

2
site/source/user-manual/flashing/flashing-pi.rst
View File

@@ -3,7 +3,7 @@
=======================
Flashing (Raspberry Pi)
=======================
This guide is for flashing StartOS to a micro SD card in order to install it on a Raspberry Pi with an external SSD. Please contact support if you need to re-install your OS on a Lite (SD card storage).
This guide is for flashing StartOS to a micro SD card in order to install it on a Raspberry Pi with an external SSD. Please `contact support <https://start9.com/contact>`_ if you need to re-install your OS on a Server Lite (SD card storage).
.. warning:: DO NOT DO THIS UNLESS YOU HAVE AN EXTERNAL SSD. If you are running in a "Lite" configuration (everything on an SD card), then flashing in the manner proscribed below WILL ERASE ALL YOUR DATA! Contact support for assistance instead.

4
site/source/user-manual/flashing/flashing-x86.rst
View File

@@ -67,7 +67,9 @@ Once you have the StartOS image, you will need to flash it onto your USB drive.
#. Click "Flash!". You may be asked to approve the unusually large disk target and/or enter your password. Both are normal.
#. After this completes, you may remove the newly flashed drive from your computer, insert it into the device you intend to install StartOS onto.
#. After this completes, you may remove the newly flashed drive from your computer, and insert it into the device you intend to install StartOS onto.
#. Plug the USB drive into the device and power on. Follow the on-screen instructions to Install StartOS (use "Re-Install" to preserve data, or "Factory Reset" to wipe the device). After install is complete, you will be prompted to remove your USB drive.
.. note:: Always perfer the fastest available USB 3.0+ port - typically this is blue or labeled "SS" (SuperSpeed)

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

@@ -90,7 +90,7 @@ If you are experiencing issues with setup, try the following:
#. Confirm that the server is plugged into both power and Ethernet
- An ethernet network with DHCP server must be available at setup. Most routers provide one. If such ethernet connectivity is not available, or there is another hardware issue, you may hear this sound:
- An ethernet network with DHCP server must be available at setup. Most routers provide this.
#. Confirm your phone/computer is **not** connected to a "Guest" network
#. Confirm your phone/computer is not using a VPN, or that if you are, that it allows LAN connections, such as the examples below:
@@ -105,7 +105,7 @@ If you are experiencing issues with setup, try the following:
- 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 always to `reach out to support <https://start9.com/contact>`_ if you need a hand.
Server Models With Speakers
---------------------------