[Bug]: manual nodes are persisted only by the desktop app, so a headless nvpair-tui node loses them on every restart
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 4/5
- Tiempo estimado
- 3-5 días
- Aptitud para principiantes
- 65/100
- Tipo de issue
- Error
- Claridad
- Bien especificado
- Estado de actividad
- Activo
- Stack tecnológico
- go, typescript
Línea de trabajo
Comienza con services/nvpair-ui-broker/manualnodes.go y services/nvpair-tui/ui/manualnodes.go, y luego compáralos con desktop/src/electron/service-bridge/manual-nodes-store.ts y el comportamiento de replay del supervisor. Reproduce el reinicio con el comando systemctl documentado e inspecciona el README de node-settings para encontrar la ruta de datos por usuario. Se considera terminado cuando los nodos manuales se persisten y se reproducen de nuevo después de ready para los front ends de TUI, desktop y service-mode.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
PAIR version or commit
Debian package nvpair 0.1.1-463 (amd64). nvpair-ui-broker --version reports 0.40.2.
Affected component
Discovery or pairing
Environment
OS: Ubuntu 26.04 LTS, x86_64
Front end: nvpair-tui only (started by a `systemd --user` unit inside tmux, linger enabled).
The Electron desktop app is not installed on these nodes.
GPU / driver: consumer NVIDIA GPUs, driver 595.91.07
Engine: Ollama 0.33.3, adopted by PAIR as the node engine
Cluster size: 5 nodes joined to one cluster, split across two routed subnets
Steps to reproduce
- On a node whose only front end is
nvpair-tui, open the Manual tab, pressa, enter a peer address, press Enter. - Confirm the entry is listed as
OLLAMA yes / NODE yes, and that the peer appears in Proxies -> Ollama upstreams. - Restart the front end and its broker:
systemctl --user restart nvpair-tui. - Open the Manual tab again.
Expected behavior
The manual node list survives a restart on any supported front end.
This matters because on a cluster split across routed subnets, manual nodes are the only way to
pair peers at all (mDNS does not cross subnets, and #1 additionally prevents reflectors from
relaying the records). Losing the list on every restart makes such a cluster impractical to
operate without the desktop app.
Actual behavior
After the restart the Manual tab shows No manual nodes. and the peer is gone from
Ollama upstreams. Nothing was written to disk: configs/manual-nodes.json never appears
in the per-user data dir, and the configs/ directory is not created.
Reading the source, the durable list appears to be implemented only in the Electron app:
desktop/src/electron/service-bridge/manual-nodes-store.tsreads and writes
<userData>/configs/manual-nodes.jsonwith entries{ id, address, name }.desktop/src/electron/service-bridge/modular-supervisor.tsnotes that
"PAIR UI owns the durable list (manual-nodes.json) and replays it once".services/nvpair-ui-broker/manualnodes.goperforms no file I/O, and
services/nvpair-tui/ui/manualnodes.goneither reads nor writes that file.services/nvpair-manual-nodesis stateless by design — its README documents
node/add,node/remove,nodes/listand no state or config-path flag.
So the replay is desktop-only, even though services/nvpair-node-settings/README.md already
describes manual-nodes.json as living in the per-user data dir, "same directory as
settings.json" — which reads as if the file is meant to be a per-node artifact rather than a
private detail of the desktop app.
Suggested fix
Move ownership of the durable list, and the one-shot replay after ready, into
nvpair-ui-broker. The broker already supervises nvpair-manual-nodes over JSON-RPC and
already has node/add available, so every front end — desktop, TUI, and any future
service mode (cf. #49, #32) — would inherit persistence without its own copy of the logic.
Sanitized logs
Manual tab, immediately after adding the entry:
ID ADDRESS OLLAMA NODE
manual:peer-a.… peer-a.example.internal yes yes
Per-user data dir at the same moment (no configs/ directory is created):
$ ls "$HOME/.config/Nvidia Corporation/Personal AI Router/configs/"
ls: cannot access '.../configs/': No such file or directory
After systemctl --user restart nvpair-tui:
No manual nodes. Press a to add one by address.
a add node • r remove node • tab next • shift+tab prev • ? help • q quit
$ ls "$HOME/.config/Nvidia Corporation/Personal AI Router/configs/"
ls: cannot access '.../configs/': No such file or directory
Related
- #1 — mDNS answers sent from an ephemeral source port, so reflectors never relay node records
across subnets. Together with this issue, a routed multi-subnet cluster cannot be kept paired
from a headless node. - #49 — Build a service version on Linux.
- #32 — Run a services-only PAIR node as a container or Kubernetes pod.
Confirmations
- I searched existing issues for duplicates.
- This is not a security vulnerability.
- I agree to follow the Code of Conduct.
- Lenguaje dominante
- Go
- Estrellas
- 1.4k
- Forks
- 250
- Merge medio
- 23 h 27 min
- PR fusionados (30 d)
- 1
Guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de NVIDIA/Personal-AI-Router
-
bug
Dificultad 4/5 3-5 días Aptitud para principiantes 55/100
NVIDIA/Personal-AI-Router#94 · 1 comentario ·
-
Dificultad 3/5 1-2 días Aptitud para principiantes 74/100
NVIDIA/Personal-AI-Router#92 · 1 comentario ·
-
NVIDIA/Personal-AI-Router#91 · 1 asignado ·
-
[Feature]: Support for Tailscale mesh network endpoints (CGNAT IPs and MagicDNS domain names) Abiertoenhancement
Dificultad 4/5 3-5 días Aptitud para principiantes 45/100
NVIDIA/Personal-AI-Router#85 · 1 comentario ·
-
NVIDIA/Personal-AI-Router#84 · 2 comentarios · 1 asignado ·
Todos los issues de NVIDIA/Personal-AI-Router
Issues similares
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 92/100
milvus-io/birdwatcher#545 ·
-
kind/bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 88/100
kubernetes-sigs/prow#953 · 1 comentario ·
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 88/100
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 88/100
caddyserver/caddy#8046 ·
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 88/100
jaegertracing/jaeger#9588 ·