Skip to content

Commit 70bd4cd

Browse files
authored
Merge pull request #1385 from Hellblazer/docs/1381-pg-bundle-remedy
docs: main-README hotfix — install-binary is not optional on 6.3.x (GH #1381)
2 parents 6df8f9b + 0e39995 commit 70bd4cd

1 file changed

Lines changed: 2 additions & 2 deletions

File tree

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -62,11 +62,11 @@ nx index repo . # index your repo + d
6262
nx search "how does retry work" # semantic search, fully local
6363
```
6464

65-
Pick `<engine-service-vX.Y.Z>` from the [engine-service releases](https://github.com/Hellblazer/nexus/releases) (the newest `engine-service-v*` tag) — there is no `latest` resolution, the tag is explicit. You can instead export `NEXUS_SERVICE_TAG=engine-service-vX.Y.Z`, in which case `nx init` acquires the binary itself and the explicit `install-binary` step is optional.
65+
Pick `<engine-service-vX.Y.Z>` from the [engine-service releases](https://github.com/Hellblazer/nexus/releases) (the newest `engine-service-v*` tag) — there is no `latest` resolution, the tag is explicit. **Keep the `install-binary` step**: it is what installs the self-contained Postgres bundle (pgvector already compiled in), so you do not need PostgreSQL installed at all. Exporting `NEXUS_SERVICE_TAG=engine-service-vX.Y.Z` instead lets `nx init` acquire the service *binary* itself, but on 6.3.x and earlier it does **not** fetch the Postgres bundle — skipping `install-binary` then requires a pgvector-capable PostgreSQL already on the machine (note: Homebrew's `pgvector` formula does not cover `postgresql@17`).
6666

6767
`nx init` provisions the bundled Postgres 17 + pgvector cluster, fetches the bge-768 ONNX model the service embeds with, starts the persistent service, and offers to register the OS autostart unit so it restarts at login/boot (prompt defaults to yes; `--yes` accepts non-interactively, `--no-autostart` starts a session supervisor only). There is **no** separate `nx daemon t2 install` step — T2 (notes/plans) is served by the same service in the default config. The permanent vector store (T3) serves through this native service; the bundled binary + Postgres are cosign-verified and acquired automatically. `nx init` is idempotent — safe to re-run. (The older `nx init --service` flag still works but is deprecated — plain `nx init` is the path now.) **First run only:** this downloads a few hundred MB (the signed ~134 MB service binary, the relocatable Postgres bundle, and the ~140 MB bge-768 model) and takes a few minutes; subsequent starts are fast.
6868

69-
> **Upgrading from a pre-6.0 install?** 6.0 moves the permanent vector store from ChromaDB to the Postgres + pgvector service. After `uv tool upgrade conexus`, run **`nx guided-upgrade`** — one command detects your existing store, provisions and version-pins the service, and migrates your data with validation and copy-not-move rollback safety. Your ChromaDB data is left intact as the migration source.
69+
> **Upgrading from a pre-6.0 install?** 6.0 moves the permanent vector store from ChromaDB to the Postgres + pgvector service. After `uv tool upgrade conexus`, run `nx daemon service install-binary <engine-service-vX.Y.Z>` (installs the self-contained Postgres bundle, pgvector included — no Homebrew/apt PostgreSQL needed), then **`nx guided-upgrade`** — one command detects your existing store, provisions and version-pins the service, and migrates your data with validation and copy-not-move rollback safety. Your ChromaDB data is left intact as the migration source. If the upgrade reports missing Postgres binaries or a missing pgvector extension, the `install-binary` step was skipped — run it and re-run `nx guided-upgrade`.
7070
7171
The `nx` CLI provides direct access to all storage tiers, indexing, search, the catalog, and taxonomy. See [Getting Started](https://github.com/Hellblazer/nexus/blob/main/docs/getting-started.md) for a walkthrough, [CLI Reference](https://github.com/Hellblazer/nexus/blob/main/docs/cli-reference.md) for every command and flag.
7272

0 commit comments

Comments
 (0)