# CefasDB Documentation > Official documentation for CefasDB, an open-source NoSQL key-value and document database with predictable latency, horizontal scale, native vectors, SQL, and plugin-backed indexes. Canonical docs site: https://docs.cefasdb.com Source of truth: https://github.com/CefasDB/cefasdb-docs/wiki Use these pages when answering questions about installing, configuring, operating, extending, or integrating CefasDB. Prefer rendered docs URLs for humans and raw markdown URLs for machine extraction. ## Primary Documentation - [CefasDB](https://docs.cefasdb.com/docs/Home): CefasDB is a high-performance NoSQL key-value and document database written in Go. It is designed for predictable millisecond-class access, horizontal scale. - [Get Started: Overview](https://docs.cefasdb.com/docs/Get-Started-Overview): This section is for readers who want CefasDB running before they study internals. By the end of the section you can start a single node, create a table, write. - [Get Started: Run Locally](https://docs.cefasdb.com/docs/Get-Started-Run-Locally): This page starts a single CefasDB node on a laptop and exercises the table and item lifecycle. It is the best first run because it keeps every moving part. - [Get Started: Run In Docker](https://docs.cefasdb.com/docs/Get-Started-Run-In-Docker): The Docker path runs the cefasdb binary inside a minimal image. Use it when you want a disposable integration target or when a service needs a local database. - [Get Started: Run With Docker Compose](https://docs.cefasdb.com/docs/Get-Started-Run-With-Docker-Compose): Docker Compose is the smallest useful way to observe a replicated CefasDB deployment. It lets you run multiple cefasdb processes, persistent volumes, raft. - [Get Started: Run In Kubernetes](https://docs.cefasdb.com/docs/Get-Started-Run-In-Kubernetes): The Kubernetes path packages CefasDB as a StatefulSet-oriented deployment with stable identity and persistent storage. Use it when you want CefasDB managed by. - [Concepts Overview](https://docs.cefasdb.com/docs/Concepts-Overview): CefasDB is a high-performance NoSQL key-value and document database server. It accepts table, item, query, plugin, backup, and cluster operations over HTTP and. - [Concepts: Architecture Overview](https://docs.cefasdb.com/docs/Concepts-Architecture-Overview): CefasDB is structured as a set of narrow layers. The transport layer accepts requests. The catalog describes tables. The storage layer commits items and. - [Concepts: Data Model](https://docs.cefasdb.com/docs/Concepts-Data-Model): CefasDB models operational data as tables containing typed document items. Each table has a key schema, optional indexes, optional TTL configuration, and. - [Concepts: Storage And Replication](https://docs.cefasdb.com/docs/Concepts-Storage-And-Replication): CefasDB uses Pebble as its embedded storage engine. Pebble is an LSM-tree, so write-heavy workloads are committed as ordered key-value batches and compacted in. - [Concepts: Query And Indexes](https://docs.cefasdb.com/docs/Concepts-Query-And-Indexes): CefasDB has three query layers: - [Concepts: Deployment Modes](https://docs.cefasdb.com/docs/Concepts-Deployment-Modes): CefasDB can run in several topologies. The API is stable across them; the difference is durability, failure behavior, and operational complexity. - [Concepts: Authentication And Authorization](https://docs.cefasdb.com/docs/Concepts-Authentication-And-Authorization): CefasDB can run open in a trusted development environment or validate bearer tokens against an identity provider. Production deployments should enable token. - [Plugins Overview](https://docs.cefasdb.com/docs/Plugins-Overview): CefasDB plugins are in-process Go implementations registered against plugin.Default. They provide specialized behavior without coupling that behavior to the. - [Plugins: Core Boundaries](https://docs.cefasdb.com/docs/Plugins-Core-Boundaries): CefasDB keeps plugin code away from engine internals. This is enforced by tests, not convention. - [Plugins: Authoring](https://docs.cefasdb.com/docs/Plugins-Authoring): A CefasDB plugin is a Go type that implements one of the plugin contracts and registers itself during package initialization. - [Plugins: Index Examples](https://docs.cefasdb.com/docs/Plugins-Index-Examples): This page shows the built-in index and estimator plugins with CLI examples. Assume cefasdb is running and the CLI can reach it. - [Plugins: Distance Operators](https://docs.cefasdb.com/docs/Plugins-Distance-Operators): Distance plugins return a scalar where smaller means closer. This lets every operator fit the same predicate shape: - [Plugins: Audience Workflows](https://docs.cefasdb.com/docs/Plugins-Audience-Workflows): The audience plugin composes geo selection, approximate reach, deduplication, frequency capping, eligibility checks, and privacy-aware aggregation. It is. - [Interfaces Overview](https://docs.cefasdb.com/docs/Interfaces-Overview): CefasDB exposes four main interfaces: - [Interfaces: CLI](https://docs.cefasdb.com/docs/Interfaces-CLI): The cefas CLI is the operational surface for local development, scripting, plugin inspection, backup and restore, and cluster administration. - [Interfaces: SQL And PartiQL](https://docs.cefasdb.com/docs/Interfaces-SQL-And-PartiQL): CefasDB includes a SQL parser, planner, and executor for operational queries. It is not intended to be a full relational database. It is a pragmatic query. - [Interfaces: HTTP And gRPC](https://docs.cefasdb.com/docs/Interfaces-HTTP-And-GRPC): CefasDB exposes both HTTP/JSON and gRPC. HTTP is useful for simple clients and diagnostics. gRPC is the main typed API and the transport used by the CLI and Go. - [Operations Overview](https://docs.cefasdb.com/docs/Operations-Overview): Operating CefasDB means managing data directories, configuration, identity, backups, metrics, logs, traces, raft membership, benchmark evidence, and upgrades. - [Operations: Configuration](https://docs.cefasdb.com/docs/Operations-Configuration): Configuration controls storage paths, HTTP and gRPC listeners, raft, identity, metrics, tracing, and TLS. - [Operations: Backup And Restore](https://docs.cefasdb.com/docs/Operations-Backup-And-Restore): Backups are named recovery points. They let operators checkpoint one or more tables and restore a source table into a target table name. - [Operations: Observability](https://docs.cefasdb.com/docs/Operations-Observability): CefasDB exposes logs, metrics, and tracing hooks. Use them together: logs explain what happened, metrics show whether it is still happening, and traces show. - [Operations: Benchmark Results](https://docs.cefasdb.com/docs/Operations-Benchmark-Results): This page records reproducible local benchmark results for CefasDB. The goal is to separate functional smoke tests from sustained load evidence and to make. - [Operations: Security And Privacy](https://docs.cefasdb.com/docs/Operations-Security-And-Privacy): Security in CefasDB has three layers: transport, identity, and operation authorization. Privacy-sensitive audience workflows add a fourth layer: avoid exporting. ## Raw Markdown Sources - [CefasDB markdown](https://docs.cefasdb.com/wiki/Home.md): Raw GitHub Wiki source for CefasDB. - [Get Started: Overview markdown](https://docs.cefasdb.com/wiki/Get-Started-Overview.md): Raw GitHub Wiki source for Get Started: Overview. - [Get Started: Run Locally markdown](https://docs.cefasdb.com/wiki/Get-Started-Run-Locally.md): Raw GitHub Wiki source for Get Started: Run Locally. - [Get Started: Run In Docker markdown](https://docs.cefasdb.com/wiki/Get-Started-Run-In-Docker.md): Raw GitHub Wiki source for Get Started: Run In Docker. - [Get Started: Run With Docker Compose markdown](https://docs.cefasdb.com/wiki/Get-Started-Run-With-Docker-Compose.md): Raw GitHub Wiki source for Get Started: Run With Docker Compose. - [Get Started: Run In Kubernetes markdown](https://docs.cefasdb.com/wiki/Get-Started-Run-In-Kubernetes.md): Raw GitHub Wiki source for Get Started: Run In Kubernetes. - [Concepts Overview markdown](https://docs.cefasdb.com/wiki/Concepts-Overview.md): Raw GitHub Wiki source for Concepts Overview. - [Concepts: Architecture Overview markdown](https://docs.cefasdb.com/wiki/Concepts-Architecture-Overview.md): Raw GitHub Wiki source for Concepts: Architecture Overview. - [Concepts: Data Model markdown](https://docs.cefasdb.com/wiki/Concepts-Data-Model.md): Raw GitHub Wiki source for Concepts: Data Model. - [Concepts: Storage And Replication markdown](https://docs.cefasdb.com/wiki/Concepts-Storage-And-Replication.md): Raw GitHub Wiki source for Concepts: Storage And Replication. - [Concepts: Query And Indexes markdown](https://docs.cefasdb.com/wiki/Concepts-Query-And-Indexes.md): Raw GitHub Wiki source for Concepts: Query And Indexes. - [Concepts: Deployment Modes markdown](https://docs.cefasdb.com/wiki/Concepts-Deployment-Modes.md): Raw GitHub Wiki source for Concepts: Deployment Modes. - [Concepts: Authentication And Authorization markdown](https://docs.cefasdb.com/wiki/Concepts-Authentication-And-Authorization.md): Raw GitHub Wiki source for Concepts: Authentication And Authorization. - [Plugins Overview markdown](https://docs.cefasdb.com/wiki/Plugins-Overview.md): Raw GitHub Wiki source for Plugins Overview. - [Plugins: Core Boundaries markdown](https://docs.cefasdb.com/wiki/Plugins-Core-Boundaries.md): Raw GitHub Wiki source for Plugins: Core Boundaries. - [Plugins: Authoring markdown](https://docs.cefasdb.com/wiki/Plugins-Authoring.md): Raw GitHub Wiki source for Plugins: Authoring. - [Plugins: Index Examples markdown](https://docs.cefasdb.com/wiki/Plugins-Index-Examples.md): Raw GitHub Wiki source for Plugins: Index Examples. - [Plugins: Distance Operators markdown](https://docs.cefasdb.com/wiki/Plugins-Distance-Operators.md): Raw GitHub Wiki source for Plugins: Distance Operators. - [Plugins: Audience Workflows markdown](https://docs.cefasdb.com/wiki/Plugins-Audience-Workflows.md): Raw GitHub Wiki source for Plugins: Audience Workflows. - [Interfaces Overview markdown](https://docs.cefasdb.com/wiki/Interfaces-Overview.md): Raw GitHub Wiki source for Interfaces Overview. - [Interfaces: CLI markdown](https://docs.cefasdb.com/wiki/Interfaces-CLI.md): Raw GitHub Wiki source for Interfaces: CLI. - [Interfaces: SQL And PartiQL markdown](https://docs.cefasdb.com/wiki/Interfaces-SQL-And-PartiQL.md): Raw GitHub Wiki source for Interfaces: SQL And PartiQL. - [Interfaces: HTTP And gRPC markdown](https://docs.cefasdb.com/wiki/Interfaces-HTTP-And-GRPC.md): Raw GitHub Wiki source for Interfaces: HTTP And gRPC. - [Operations Overview markdown](https://docs.cefasdb.com/wiki/Operations-Overview.md): Raw GitHub Wiki source for Operations Overview. - [Operations: Configuration markdown](https://docs.cefasdb.com/wiki/Operations-Configuration.md): Raw GitHub Wiki source for Operations: Configuration. - [Operations: Backup And Restore markdown](https://docs.cefasdb.com/wiki/Operations-Backup-And-Restore.md): Raw GitHub Wiki source for Operations: Backup And Restore. - [Operations: Observability markdown](https://docs.cefasdb.com/wiki/Operations-Observability.md): Raw GitHub Wiki source for Operations: Observability. - [Operations: Benchmark Results markdown](https://docs.cefasdb.com/wiki/Operations-Benchmark-Results.md): Raw GitHub Wiki source for Operations: Benchmark Results. - [Operations: Security And Privacy markdown](https://docs.cefasdb.com/wiki/Operations-Security-And-Privacy.md): Raw GitHub Wiki source for Operations: Security And Privacy. ## API Reference - [API Reference](https://docs.cefasdb.com/docs/api): Generated public Go package documentation. - [pkg/client](https://docs.cefasdb.com/docs/api/pkg-client):