> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lingxilearn.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration reference

> Agent Server, worker, authentication, Redis, and OpenTelemetry environment variables

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:

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

Multiple versions under one ID:

```json theme={null}
{
  "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:

```bash theme={null}
lingxigraph doctor
```

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

## CLI process options

```text theme={null}
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]
```

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