Configure
Configure
Configure sources, databases, auth, caching, uploads, OpenAPI, and production settings.
Configuration pages turn the reference files into decision-oriented guides. New to GraphJin config? Start with How Configuration Works — it explains the one-file/two-halves model, how values are resolved, and every way to change config (editor, CLI, agent, MCP, GraphQL). The pages below go deep on each area.
| Page | What it covers |
|---|---|
| How Configuration Works | The mental model plus every interface: editor autocomplete, the deeporg config CLI, the agent, MCP tools, and gj_config. |
| Sources Mode | Named providers for databases, files, APIs, CodeSQL, workflows, and GraphJin system roots. |
| Database Config | Single and multi-database connection settings, pools, TLS, table mapping, and relationships. |
| Auth And RBAC | JWT/OIDC auth, identity claims, role queries, source access, table rules, and column controls. |
| Caching And Redis | Response cache keys, stale-while-revalidate, Redis sharing, and invalidation. |
| Discovery Cache And Semantic Search | Cache-first schema generations, single-node and horizontal coordination, Ax embeddings, dimensions, and hybrid catalog retrieval. |
| Uploads And Filesystems | File sources, uploads, local/S3/GCS backends, presigned URLs, and read-only policy. |
| OpenAPI Config | API sources, spec discovery, auth, joins, result paths, and operation overrides. |
| Environment And Production | dev, prod, and agentic modes, inheritance, environment variables, and production defaults. |
New deployments should prefer sources: for all graph providers. Legacy top-level database-only config still exists for simple apps, but file, API, CodeSQL, workflow, catalog, and security surfaces are source-mode features.
How Configuration Works
The mental model behind GraphJin config — one file, two halves, layered overrides — and every way to change it: editor, CLI, the agent, MCP, and GraphQL.
Sources Mode
Configure named sources and capabilities for databases, files, APIs, code, and system surfaces.
Database Config
Configure database connections, pools, TLS, supported database types, and table mapping.
Auth And RBAC
Configure authentication, role queries, table permissions, row filters, and column blocking.
Caching And Redis
Configure response caching, stale-while-revalidate, Redis backend selection, and invalidation.
Discovery Cache And Semantic Search
Start from durable schema generations, coordinate refreshes across replicas, and add Ax-backed semantic recall to catalog search.
Uploads And Filesystems
Configure multipart uploads and object-store-backed filesystem tables.
OpenAPI Config
Configure OpenAPI specs, auth schemes, operation overrides, naming, and collision handling.
Environment And Production
Use environment-specific config files, inheritance, environment variables, and production defaults.