Configuration reference

LingxiGraph configures processes through environment variables and registers trusted graphs through lingxigraph.json. Source sensitive values from a secret manager or orchestrator Secret.

Environment variables

Name	Required	Description
`LINGXIGRAPH_POSTGRES_URL`	Production	PostgreSQL DSN shared by server, worker, migrations
`LINGXIGRAPH_REDIS_URL`	No	Redis PubSub/cache/cancel acceleration; degradable
`LINGXIGRAPH_OIDC_ISSUER`	Production	Allowed JWT issuer
`LINGXIGRAPH_OIDC_AUDIENCE`	Production	JWT audience
`LINGXIGRAPH_OIDC_JWKS_URL`	Production	Trusted JWKS endpoint
`LINGXIGRAPH_TENANT_CLAIM`	No	Tenant claim; default `tenant_id`
`LINGXIGRAPH_ROLES_CLAIM`	No	Roles claim; default `roles`
`LINGXIGRAPH_INSECURE_DEV_AUTH`	Dev only	Set `true` for insecure auth
`LINGXIGRAPH_DEV_API_KEY`	Dev only	Development `X-API-Key`
`LINGXIGRAPH_DEV_TENANT`	Dev only	Default tenant for the development key
`LINGXIGRAPH_DEV_ROLES`	Dev only	Roles for the development key
`LINGXIGRAPH_LOG_LEVEL`	No	Log level; default `INFO`
`LINGXIGRAPH_LOG_FORMAT`	No	`json` (default) or text
`OTEL_EXPORTER_OTLP_ENDPOINT`	No	Enables OTLP export when set
`OTEL_SERVICE_NAME`	No	Telemetry service name

Graph manifest

Single version:

{
  "$schema": "https://lingxigraph.dev/schemas/manifest-v1.json",
  "graphs": {
    "support": {
      "path": "myapp.graphs:support_graph",
      "version": "1.0.0"
    }
  }
}

Multiple versions under one ID:

{
  "graphs": {
    "support": [
      {"path": "myapp.graphs:support_v1", "version": "1.0.0"},
      {"path": "myapp.graphs:support_v2", "version": "2.0.0"}
    ]
  }
}

The last list item is the default for new assistants. Keep every old version still pinned by a run. Before deployment, run:

lingxigraph doctor

It imports the manifest, compiles graphs, and checks JSON Schemas and critical production configuration.

CLI process options

lingxigraph server --host 0.0.0.0 --port 8124 --manifest lingxigraph.json [--embedded-worker]
lingxigraph worker --manifest lingxigraph.json --health-host 0.0.0.0 --health-port 8125 --drain-timeout 60
lingxigraph dev --host 127.0.0.1 --port 8124 --manifest lingxigraph.json [--reload] [--no-open]

Never put database passwords, OIDC secrets, model tokens, or remote-agent credentials in the manifest, graph state, context, events, traces, or ConfigMaps.

Get started

Core concepts

Guides

API reference

Operations and project

Configuration reference

Environment variables

Graph manifest

CLI process options

​Environment variables

​Graph manifest

​CLI process options

Environment variables

Graph manifest

CLI process options