initial bootstrapping workflow

README.md

@@ -1,10 +1,20 @@
 # Raspberry Pi NAS
 
-This repository contains all configuration I use to set up a Raspberry Pi 4B as
-a NAS and media storage server. This repository will most likely evolve a lot.
+Ansible configuration repository for my Raspberry Pi's.
 
-The Pi is used to host the following:
+## Initial setup for new systems
 
-* Samba network share for access to family pictures
-* [Photoview](https://photoview.github.io/) instance for accessing image over the internet
-* [Jellyfin](https://jellyfin.org/) for accessing media library as well
+1. Flash [Debian Raspberry Pi](https://raspi.debian.net/) on the SD card.
+2. Configure `/boot/firmware/sysconf.txt`
+    1. Set `hostname` to the desired name
+    2. Set `root_authorized_key` to the contents of the current computer's
+      public SSH key
+3. Put SD card in Pi and boot
+4. Connect Pi to wired internet
+5. Determine IP address given to the new Pi
+6. Add this IP address to the `initial-hosts.ini` file, along with the
+   `static_ip` host var set to the desired static IP address
+8. Comment out `ansible_ssh_user` in `group_vars/all/vars.yml`, as this
+   overwrites the one set in the hosts file
+9. Run `ansible-playbook -i initial-hosts.ini first_run.yml`. This command will
+   hang at the `restart networking` step; at this point you can Ctrl-C.