From f88dfa7620a289f1aff63e446ebdd31853ac3d51 Mon Sep 17 00:00:00 2001
From: Craig Jennings <c@cjennings.net>
Date: Sat, 8 Aug 2026 04:55:52 -0500
Subject: docs: add the post-install checklist and podman/camera-udev notes

The checklist is the standing home for manual post-first-boot steps: bluetooth pairing and the Proton Bridge login start it. The podman-socket and camera-udev notes carry the evidence for the filed install-time task, including why uaccess alone can't grant a raw USB node.
---
 docs/post-install-checklist.org | 48 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 docs/post-install-checklist.org

(limited to 'docs/post-install-checklist.org')

diff --git a/docs/post-install-checklist.org b/docs/post-install-checklist.org
new file mode 100644
index 0000000..fa704b6
--- /dev/null
+++ b/docs/post-install-checklist.org
@@ -0,0 +1,48 @@
+#+TITLE: Post-Install Checklist
+#+AUTHOR: Craig Jennings
+#+DATE: 2026-08-08
+
+* About
+
+Manual steps a fresh archsetup install cannot automate — things that are
+inherently interactive (pairing, account logins) or that need judgment on the
+specific machine. Work through this after first boot. When a new manual step
+is discovered during a machine setup, add it here rather than leaving it in a
+session note; the installer's outro already points at the Proton Bridge steps,
+and this file is the home for the rest.
+
+Steps that CAN be automated don't belong here — file them as installer tasks
+instead. The 2026-04-10 velox setup notes were triaged exactly that way:
+microcode, radio state, and the ZFS /tmp mask went into the installer;
+bluetooth pairing landed below.
+
+* Checklist
+
+** Pair bluetooth peripherals
+
+Pairing is inherently interactive (scan, pick the device, confirm), so it
+can't ride the installer. For a mouse (e.g. the Logi M650):
+
+#+begin_src sh
+bluetoothctl
+# inside the prompt:
+#   scan on          — wait for the device to appear
+#   pair <MAC>
+#   trust <MAC>      — trust makes it auto-reconnect at boot
+#   connect <MAC>
+#   scan off
+#+end_src
+
+Trusted devices reconnect on their own after reboot; if one doesn't, check
+=rfkill list= first (radios should be unblocked — TLP owns radio state and
+enables bluetooth/wifi at startup per =/etc/tlp.d/01-custom.conf=).
+
+** Proton Mail Bridge (cmail)
+
+The installer's completion message carries the steps; recorded here too so
+the checklist is complete:
+
+1. Clone claude-templates to =~/projects/claude-templates= if missing.
+2. Run =protonmail-bridge --cli=, log in, then quit.
+3. Run =~/code/archsetup/scripts/cmail-setup-finish.sh=.
+4. First mail sync: =mbsync cmail && mu index=.
-- 
cgit v1.2.3