Files
pipelines/docs/notes/two-machine-install-checklist.md
T

48 lines
2.8 KiB
Markdown

# 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.
## Sharing Android updates between machines
Android updates must use the signing identity of the app already installed.
New APK feeds report the certificate fingerprint; the client skips advertised
mismatches even if their build number is higher. Old feeds without fingerprints
retain their legacy behavior and Android still validates installation.
To offer the same phone app from both machines, copy the published
`lib/app-updates/pipelines.apk` and matching `version.json` to the second server's
`lib/app-updates/` (publish the APK before its feed). These are distribution files,
not signing keys or provider credentials. A separately generated Linux signing
key cannot update a phone app signed by the Mac key. Keep the existing phone app
and its data; it can still connect to both server profiles regardless of where
its APK was built.