# agdb Documentation

> Guides, API docs, references, and examples for agdb.

## Documentation Sets

- [agdb Full Documentation](https://agdb.agnesoft.com/llms-full.txt): Complete docs for using agdb, running agdb_server, and integrating API clients.

## Guides

- [Concepts](https://agdb.agnesoft.com/raw/docs/guides/concepts.md): Core concepts: graph model, object queries, transactions, storage
- [Quickstart](https://agdb.agnesoft.com/raw/docs/guides/quickstart.md): Embedded agdb quickstart: set up Rust app, create a DB, and run native object queries
- [Overview](https://agdb.agnesoft.com/raw/docs/guides/how-to-run-server.md): Run agdb_server on bare metal, Docker, or Kubernetes — single node or cluster
- [Bare metal](https://agdb.agnesoft.com/raw/docs/guides/how-to-run-server/server-bare-metal.md): Run agdb_server on bare metal: install, build (optional pepper), configure, and start
- [Docker](https://agdb.agnesoft.com/raw/docs/guides/how-to-run-server/server-docker.md): Run agdb_server in Docker: pull/build image, persist data, enable TLS
- [Kubernetes](https://agdb.agnesoft.com/raw/docs/guides/how-to-run-server/server-k8s.md): Deploy single agdb_server on Kubernetes: Service, Secrets, ConfigMap, StatefulSet, and TLS
- [Bare metal (cluster)](https://agdb.agnesoft.com/raw/docs/guides/how-to-run-server/cluster-bare-metal.md): Run agdb_server cluster on bare metal: prepare per-node config, start nodes, verify status, and shutdown
- [Docker (cluster)](https://agdb.agnesoft.com/raw/docs/guides/how-to-run-server/cluster-docker.md): Run agdb_server cluster in Docker: compose file, images, ports, TLS, and shutdown
- [Kubernetes (cluster)](https://agdb.agnesoft.com/raw/docs/guides/how-to-run-server/cluster-k8s.md): Deploy agdb_server cluster on Kubernetes: StatefulSet, secrets, ConfigMap, TLS, and service routing
- [How to use studio?](https://agdb.agnesoft.com/raw/docs/guides/how-to-use-studio.md)
- [Troubleshooting](https://agdb.agnesoft.com/raw/docs/guides/troubleshooting.md): Troubleshooting common agdb issues: CORS, setup, clients
- [Guides](https://agdb.agnesoft.com/raw/docs/guides.md): Guides for agdb: concepts, quickstarts, server deployment, studio, and troubleshooting

## Examples

- [Overview](https://agdb.agnesoft.com/raw/docs/examples.md): agdb examples: embedded app, indexes, joins, schema migration, and server clients

## References

- [Overview](https://agdb.agnesoft.com/raw/docs/references.md): Reference docs for agdb: queries, server, studio, performance, and cloud
- [Queries](https://agdb.agnesoft.com/raw/docs/references/queries.md): agdb query model: immutable and mutable object queries for constant‑time graph access
- [Server](https://agdb.agnesoft.com/raw/docs/references/server.md): OpenAPI REST server for agdb with Axum, TLS, clustering, and admin APIs
- [Studio](https://agdb.agnesoft.com/raw/docs/references/studio.md)
- [Cloud](https://agdb.agnesoft.com/raw/docs/references/cloud.md): Cloud deployment and hosting options for agdb
- [Efficient agdb](https://agdb.agnesoft.com/raw/docs/references/efficient-agdb.md): Designing efficient agdb schemas and queries for realistic workloads
- [Performance](https://agdb.agnesoft.com/raw/docs/references/performance.md): Performance benchmarks and principles: ACID, O(1) access, read concurrency

## API Clients

- [OpenAPI](https://agdb.agnesoft.com/raw/api-docs/openapi.md): OpenAPI specification for agdb server and language clients
- [Rust](https://agdb.agnesoft.com/raw/api-docs/rust.md): Rust client: async OpenAPI client for agdb with Reqwest and trait‑based HTTP abstraction
- [PHP](https://agdb.agnesoft.com/raw/api-docs/php.md): PHP client: generated OpenAPI SDK for agdb with quickstart
- [Typescript / Javascript](https://agdb.agnesoft.com/raw/api-docs/typescript.md): TypeScript/JavaScript client: OpenAPI Axios SDK with usage examples

## Blog

- [Distance](https://agdb.agnesoft.com/raw/blog/distance.md): Blog: efficient distance search patterns in agdb graphs
- [Why graph?](https://agdb.agnesoft.com/raw/blog/why-graph.md): Blog: why agdb uses graphs — flexibility, performance, and simplicity
- [Object queries](https://agdb.agnesoft.com/raw/blog/object-queries.md): Blog: native object queries in agdb — safety and expressiveness
- [Single file](https://agdb.agnesoft.com/raw/blog/single-file.md): Blog: single‑file storage in agdb — simplicity and durability
- [Sharding, replication and performance at scale](https://agdb.agnesoft.com/raw/blog/replication-sharding-performance.md): Blog: replication, sharding, and performance trade‑offs in agdb
- [Why not SQL?](https://agdb.agnesoft.com/raw/blog/why-not-sql.md): Blog: limitations of SQL for modern app-native data — agdb’s alternative
- [Blog](https://agdb.agnesoft.com/raw/blog.md): agdb blog: architecture insights, performance notes, and design rationale

## Enterprise

- [Technical Consultation](https://agdb.agnesoft.com/raw/enterprise/consultation.md): Technical consultation for agdb: architecture reviews, performance tuning, and integration support
- [Cloud](https://agdb.agnesoft.com/raw/enterprise/cloud.md): agdb cloud options: managed hosting, deployment models, and SLAs
- [Self-hosted](https://agdb.agnesoft.com/raw/enterprise/self-hosted.md): Self-hosted agdb: deployment options, maintenance guidance, and best practices
- [Support](https://agdb.agnesoft.com/raw/enterprise/support.md): Enterprise support for agdb: SLAs, priority fixes, and guidance
- [Sponsors](https://agdb.agnesoft.com/raw/enterprise/sponsors.md): Sponsor agdb: help fund development and shape roadmap
- [Enterprise](https://agdb.agnesoft.com/raw/enterprise.md): Enterprise options for agdb: support, sponsorships, consultation, and cloud hosting