diff --git a/source/_static/images/diy/balena.png b/source/_static/images/diy/balena.png new file mode 100644 index 0000000..9096519 Binary files /dev/null and b/source/_static/images/diy/balena.png differ diff --git a/source/_static/images/diy/pi.png b/source/_static/images/diy/pi.png new file mode 100644 index 0000000..e7d1457 Binary files /dev/null and b/source/_static/images/diy/pi.png differ diff --git a/source/_static/images/diy/pins.png b/source/_static/images/diy/pins.png new file mode 100644 index 0000000..d9409a6 Binary files /dev/null and b/source/_static/images/diy/pins.png differ diff --git a/source/getting-started/diy.rst b/source/getting-started/diy.rst index f251ccd..8c9de90 100644 --- a/source/getting-started/diy.rst +++ b/source/getting-started/diy.rst @@ -2,4 +2,83 @@ *** DIY -*** \ No newline at end of file +*** + +.. figure:: /_static/images/diy/pi.png + :width: 90% + :alt: Raspberry Pi + + Raspberry Pi Board + +By popular demand, we are pleased to present this "Do it Yourself" (DIY) guide for the Start9 Embassy personal server! + +Motivation +========== + +There are three reasons you might prefer to build your own Embassy instead of purchasing one from us. + +#. You already have a Raspberry Pi and would like to re-purpose it + +#. You live outside the United States and want to save on shipping/duties fees + +#. You just like building things. + +Hardware +======== + +Components +---------- +#. `Raspberry Pi 4B (4GB) `_ +#. `Power supply for Raspberry Pi 4B `_ +#. Case for Raspberry Pi 4B (plenty on Amazon) +#. High endurance microSD card (recommended 128GB or more) +#. `GPIO mini speaker/buzzer `_ +#. Ethernet cable +#. MicroSD → USB adapter (if no microSD port on your computer) + +Assembly Instructions +--------------------- + +#. Insert mini speaker/buzzer into GPIO pins 6/8/10/12 with the word "speaker" facing out, `away from the board`. + +.. figure:: /_static/images/diy/pins.png + :width: 90% + :alt: Speaker board spec + +#. That's it. Place the Raspberry Pi 4 board (with speaker attached), into its case. + +Getting EmbassyOS +================= + +Purchasing +---------- + +You can purchase EmbassyOS `here `_. This is by far the easiest path to get up and running. + +Depending on your Internet speed, the download should take between 5 and 30 minutes. + +Building from Source +-------------------- + +If you have the proper tooling and are comfortable using the command line, you can build EmbassyOS from `source `_, which is made available under the `Start9 Personal Use License `_. + +Installing EmbassyOS +-------------------- + +Whether you purchase EmbassyOS from us or build it yourself, you need to flash it onto a microSD card. + +1. Download `balenaEtcher `_ onto your Mac, Windows, or Linux computer. +2. Insert the microSD card into your computer, either directly or using an adapter. +3. Open balenaEtcher. +4. Click `Select Image`, then find and select your copy of EmbassyOS. +5. Click `Select Target`, then find and select your micro SD card. +6. Click `Flash!` You may be asked to (1) approve the unusually large disk target or (2) enter your password. Both are normal. + +.. figure:: /_static/images/diy/balena.png + :width: 90% + :alt: Balena Etcher Dashboard + +7. Once the image is flashed and verified, you may remove the micro SD and insert it into your Embassy. +8. The Embassy is now ready for use, and you may following the normal :ref:`setup ` instructions. * + +``*`` The first time you power it on, your Embassy will make more noises than future attempts, and it may take several minutes to finally complete. \ No newline at end of file