From ae4a54754899b2244f4c92f8c58a470a183fe3b4 Mon Sep 17 00:00:00 2001
From: naps62-yolo <yolo-git-naps-pt@naps62.com>
Date: Mon, 25 May 2026 14:45:16 +0000
Subject: [PATCH] docs(maestro): switch INSTALL.md to the private-repo flow
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

`curl | sh` only works for public repos — gitea hides private repos with a
404 to unauthenticated clients. Lead with downloading `install.sh` via the
signed-in web UI (or `git show origin/main:install.sh`) and running it
locally. Note that the inner `cargo install --git` still uses whatever git
credentials the host already has, and document `MAESTRO_REPO_URL=ssh://...`
for SSH-only setups.

Refs NAP-225.
---
 docs/INSTALL.md | 28 +++++++++++++++++++++-------
 1 file changed, 21 insertions(+), 7 deletions(-)

diff --git a/docs/INSTALL.md b/docs/INSTALL.md
index a3b8df4..132288a 100644
--- a/docs/INSTALL.md
+++ b/docs/INSTALL.md
@@ -1,19 +1,33 @@
 # Installing Maestro
 
-One command, used for both first install and subsequent updates:
+The repo is private, so grab `install.sh` while signed in to gitea, then run it:
 
-```sh
-curl -sSf https://git.naps.pt/naps62/maestro/raw/branch/main/install.sh | sh
-```
+1. Open <https://git.naps.pt/naps62/maestro/src/branch/main/install.sh>, click
+   **Raw**, save as `install.sh`. Or from any existing clone:
+   ```sh
+   git show origin/main:install.sh > install.sh
+   ```
+2. Run it:
+   ```sh
+   chmod +x install.sh && ./install.sh
+   ```
 
 The bootstrap script builds `maestro-installer` into a temp directory, runs the
 wizard, and cleans up — only `maestrod` and `maestro` end up persisted in
 `~/.cargo/bin`. Re-run any time to update; `cargo install` overwrites in place.
 
-Pass flags through to the wizard via `sh -s --`:
+Inside the script, `cargo install --git https://git.naps.pt/naps62/maestro …`
+uses your already-configured git credentials for this host (HTTPS helper or
+SSH agent). If only SSH is set up:
 
 ```sh
-curl -sSf https://git.naps.pt/naps62/maestro/raw/branch/main/install.sh | sh -s -- --yes --no-systemd
+MAESTRO_REPO_URL=ssh://git@git.naps.pt/naps62/maestro ./install.sh
+```
+
+Pass flags through to the wizard after `./install.sh`:
+
+```sh
+./install.sh --yes --no-systemd
 ```
 
 The wizard:
@@ -70,7 +84,7 @@ journalctl --user -u maestrod -f
 
 ## Running the wizard without the bootstrap script
 
-If you'd rather not pipe a script:
+If you'd rather skip the script:
 
 ```sh
 cargo install --git https://git.naps.pt/naps62/maestro maestro-installer