From c05556eb7b8743c3d067d3273a81267615eb9052 Mon Sep 17 00:00:00 2001
From: Davy <95214375+thedavidweng@users.noreply.github.com>
Date: Fri, 18 Sep 2026 16:39:07 -0700
Subject: [PATCH] readme: clarify root/deck context and fix update commands

Signed-off-by: Davy <95214375+thedavidweng@users.noreply.github.com>
---
 readme.md | 22 ++++++++++++++++++----
 1 file changed, 18 insertions(+), 4 deletions(-)

diff --git a/readme.md b/readme.md
index 05ad83d..8300ee4 100644
--- a/readme.md
+++ b/readme.md
@@ -12,12 +12,26 @@
 4. Run `tailscale up --qr --operator=deck --ssh` to have Tailscale generate
    a login QR code. Scan the code with your phone and authenticate with
    Tailscale to bring your Deck onto your network.
+5. Run `exit` to return to your normal user shell once you're done.
 
 ## Updating Tailscale
 
-Tailscale should be able to update itself now! Try running
-`sudo tailscale update`, and if that works, `sudo tailscale set --auto-update`.
-If it doesn't, keep reading.
+Tailscale should be able to update itself now!
+
+If you are still in the root shell from the installation steps above, run:
+```bash
+tailscale update
+tailscale set --auto-update
+```
+
+If you are running as the standard `deck` user, `sudo` will not find `tailscale` directly because `/opt/tailscale` is not in `sudo`'s default `secure_path`. Use the full binary path for the update:
+```bash
+sudo /opt/tailscale/tailscale update
+tailscale set --auto-update
+```
+*(Note: `--operator=deck` was configured during installation, so `tailscale set` can be run without `sudo`.)*
+
+If it doesn't work, keep reading.
 
 > ⚠️ This process will most likely fail if you are accessing the terminal over
 > Tailscale SSH, as it seems to be locked in a chroot jail. You should start and
@@ -29,7 +43,7 @@ If it doesn't, keep reading.
 
 To benefit from improvements to the install script, consider rerunning it from time to time.
 
-1. Git fetch and pull to make sure you're up to date:
+1. Git fetch and pull to make sure you're up to date (from the standard `deck` user):
    1. `cd ~/deck-tailscale`
    2. `git pull`
 2. Run `sudo bash tailscale.sh` again.