Skip to content

Shared Daemon

Nexus = filesystem/context plane.

Choose this path when Nexus needs to run as a service instead of as an in-process library.

What Changes

  • You start nexusd as the server process.
  • Remote SDK clients use the remote profile.
  • The remote SDK path depends on gRPC as well as the HTTP server URL.

Server

In a clean install, a minimal daemon setup looks like this:

export NEXUS_GRPC_PORT=2126
nexusd --profile minimal --host 127.0.0.1 --port 2026 --data-dir ./nexus-data --api-key dev-key

Client

from nexus.sdk import connect

nx = connect(
    config={
        "profile": "remote",
        "url": "http://127.0.0.1:2026",
        "api_key": "dev-key",
    }
)

Set NEXUS_GRPC_PORT in the client environment if the server is not using the default gRPC port expected by the SDK.

Trust Notes

  • The HTTP port alone is not enough for the current remote SDK path.
  • Documented remote access should always mention the gRPC requirement explicitly.
  • If you only need local development, start with the Local SDK path.