From eea4b1ddc93076398ad841b27a4cb385f2293568 Mon Sep 17 00:00:00 2001 From: Alan Silva Date: Sun, 8 Nov 2026 16:48:57 +0000 Subject: [PATCH] Document second-machine installation and verification scope --- docs/notes/two-machine-install-checklist.md | 32 +++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 docs/notes/two-machine-install-checklist.md diff --git a/docs/notes/two-machine-install-checklist.md b/docs/notes/two-machine-install-checklist.md new file mode 100644 index 00000000..5465f578 --- /dev/null +++ b/docs/notes/two-machine-install-checklist.md @@ -0,0 +1,32 @@ +# Installing a second machine + +Install the server independently on the Linux computer using the current source +checkout and `./install`. The Linux user needs a logged-in `systemctl --user` +session, Go as pinned in go.mod, Node 18+, Python 3.9+, a C compiler, git, curl, +running Docker, and its own configured OpenCode installation. See ../install.md. +This does not transfer provider credentials or the Mac server database. + +On the phone, keep the existing app/data and add the Linux server in Settings → +Servers. Give each logical server a distinct name (for example Mac and Linux). +Add alternative LAN/tailnet addresses as endpoints of the same logical server; +add the second computer as a separate server. Sign in to each machine separately. +The app retains separate credentials and server-scoped navigation/drafts. + +New chat asks for the machine before loading that machine's harness choices. +Pipeline, run and chat metadata identifies the selected machine. Lists retain +their existing selected-server context; this release does not aggregate both +machines into a single list. + +For a desktop client alone, use `./install --linux --output ./dist` or +`./install --macos --flutter /path/to/flutter --output ./dist`. These commands +build clients without installing a server. Add `--publish` to offer the resulting +platform build from an installed server's authenticated update feed. Android, +Linux and macOS clients check saved machines for compatible updates; desktop +archives are downloaded rather than replacing the running application. + +Manager verification before delivery: 53 native-installer regression tests, +15 app-builder tests, and an isolated source lifecycle smoke test passed. The +smoke test used a private HOME/config/database and no model inference. Linux +systemd login startup and installation on the operator's Linux computer remain +for that physical-machine test; successful Docker client compilation does not +verify either. No Android device was connected during this release preparation.