RasPi

config/iot/raspberry-pi.md

@@ -9,38 +9,69 @@ breadcrumbs:
 ### Using
 {:.no_toc}
 
-- 1B
-- 3B
-
-## Raspbian Basic Setup
-
-- Default credentials: Username `pi`, password `raspberry`.
-- Configure through the menu: `raspi-config`
-  - Go through all the options.
-  - Locale and default locale: Use `en_US.UTF-8`.
-  - Disable all interfaces except SSH (disable SSH too if not needed).
-  - If a black border is present, disable overscan.
-- Upgrade the system: `apt update && apt upgrade`
-- Install packages: `vim htop screen`
-- Add personal admin user:
-  - Create user: `adduser <user>`
-  - Add SSH key (from a GitHub user in this case):
-    - `cd /home/<user>`
-    - `mkdir .ssh`
-    - `curl https://github.com/<user>.keys >> .ssh/authorized_keys`
-    - `chown -R <user>:<user> .ssh`
-    - `chmod 700 .ssh` and `chmod 600 .ssh/*`
-  - Make user sudoer: `usermod -aG sudo <user>`
-  - Let user see system logs: `usermod -aG systemd-journal <user>`
-  - Try loggin into the user locally and through SSH
-- Delete default user: `deluser pi`
-- Configure SSHD:
-  - `PermitRootLogin no`
-  - `PasswordAuthentication no`
-  - `AllowTcpForwarding no`
-  - `GatewayPorts no`
-  - `AcceptEnv LANG LC_*`
-  - Restart `sshd` and try to open a new session.
-- Remove the MOTD: `> /etc/motd`
+**OS:** Raspbian Buster
+
+**Hardware models:** B, 3B
+
+## Setup
+
+### Installation
+
+1. Download Raspbian: [Download Raspbian (Raspberry Pi)](https://www.raspberrypi.org/downloads/raspbian/)
+    - Use the desktop version for DE and the Lite version for no DE.
+1. Burn it to the SD card.
+    - Make sure the SD card is compatible: [SD Cards (Raspberry Pi)](https://www.raspberrypi.org/documentation/installation/sd-cards.md)
+    - Windows: Use Win32DiskImager.
+1. Mount the SD card in the Raspi and power it on.
+
+### Basic Setup with Desktop Environment
+
+1. Follow the configuration wizard.
+    - Set a password for the "pi" user.
+1. Turn off Bluetooth and/or Wi-Fi if not used.
+1. In "Raspberry Pi Configuration":
+    1. (Optional) Disable auto login.
+    1. Disable all unused interfaces.
+    1. Fix the keyboard layout.
+
+### Basic Setup without Desktop Environment
+
+1. Default credentials: Username `pi`, password `raspberry`.
+1. Configure through the menu: `raspi-config`
+    - Go through all the options.
+    - Locale and default locale: Use `en_US.UTF-8`.
+    - Disable all interfaces except SSH (disable SSH too if not needed).
+    - If a black border is present, disable overscan.
+1. Upgrade the system and install stuff:
+    - Upgrade: `apt update && apt upgrade`
+    - Install basics: `apt install vim htop screen`
+1. Add personal admin user:
+    1. Create user: `adduser <user>`
+    1. Add SSH key (from a GitHub user in this case):
+        1. `cd /home/<user>`
+        1. `mkdir .ssh`
+        1. `curl https://github.com/<user>.keys >> .ssh/authorized_keys`
+        1. `chown -R <user>:<user> .ssh`
+        1. `chmod 700 .ssh` and `chmod 600 .ssh/*`
+    1. Make user sudoer: `usermod -aG sudo <user>`
+    1. Let user see system logs: `usermod -aG systemd-journal <user>`
+    1. Try logging into the user locally and through SSH.
+1. Delete default user: `deluser pi`
+1. Configure SSHD:
+    - `PermitRootLogin no`
+    - `PasswordAuthentication no`
+    - `AllowTcpForwarding no`
+    - `GatewayPorts no`
+    - `AcceptEnv LANG LC_*`
+    - Restart `sshd` and try to open a new session.
+1. Remove the MOTD: `> /etc/motd`
+
+## Applications
+
+### Raspotify
+
+A Spotify Connect community client.
+
+See [dtcooper/raspotify (GitHub)](https://github.com/dtcooper/raspotify).
 
 {% include footer.md %}