---
title: "camada docs: quickstarts, SDK reference and webhooks"
description: "Install camada in your framework, then read the reference: webhook payloads, rules and list entries, challenges, billing, the chat agent and the API."
url: https://www.camada.app/docs
last_updated: 2026-10-26
---

Docs

# camada docs

## Quickstarts

- [Express](https://www.camada.app/docs/quickstart/express) `@camada/node`
- [Fastify](https://www.camada.app/docs/quickstart/fastify) `@camada/node`
- [NestJS](https://www.camada.app/docs/quickstart/nest) `@camada/node`
- [Koa](https://www.camada.app/docs/quickstart/koa) `@camada/node`
- [Next.js](https://www.camada.app/docs/quickstart/nextjs) `@camada/next`
- [FastAPI](https://www.camada.app/docs/quickstart/fastapi) `camada`
- [Django](https://www.camada.app/docs/quickstart/django) `camada`
- [Flask](https://www.camada.app/docs/quickstart/flask) `camada`
- [Go](https://www.camada.app/docs/quickstart/go) `github.com/camada-app/camada-go`
- [Rails](https://www.camada.app/docs/quickstart/rails) `camada`
- [PHP](https://www.camada.app/docs/quickstart/php) `camada/camada`
- [Laravel](https://www.camada.app/docs/quickstart/laravel) `camada/camada`
- [Spring Boot](https://www.camada.app/docs/quickstart/spring) `dev.camada:camada`
- [ASP.NET Core](https://www.camada.app/docs/quickstart/aspnet) `Camada`
- [Hono on Workers](https://www.camada.app/docs/hono) `@camada/hono`
- [Python (ASGI/WSGI)](https://www.camada.app/docs/python) `camada`
- [Go (net/http)](https://www.camada.app/docs/go) `github.com/camada-app/camada-go`
- [PHP (front controller, Laravel)](https://www.camada.app/docs/php) `camada/camada`
- [Ruby (Rack, Rails)](https://www.camada.app/docs/ruby) `camada`
- [Java (servlet, Spring Boot)](https://www.camada.app/docs/java) `dev.camada:camada`
- [.NET (ASP.NET Core)](https://www.camada.app/docs/dotnet) `Camada`

## Reference

- [Webhook payload](https://www.camada.app/docs/webhooks) catalog, signature, retries
- [API reference](https://my.camada.app/api/openapi.json) OpenAPI 3.1, served by the app
- [How billing works](https://www.camada.app/docs/billing) plans, trial, overage
- [Chat with your agent](https://www.camada.app/docs/chat) tools, change cards, workflows
- [Memory](https://www.camada.app/docs/memory) facts, index, retention
- [Rules and list entries](https://www.camada.app/docs/rules) IP, CIDR, path, ASN, country
- [Challenge](https://www.camada.app/docs/challenge) proof of work, cookie, SDK support
- [Signals and rules](https://www.camada.app/how-it-works)

## Operate

- [Fail-open behaviour and data handling](https://www.camada.app/security)
- [Service status](https://www.camada.app/status)
- [Contact](https://www.camada.app/contact)

Env

## Environment variables the SDKs read

| Variable | Meaning |
| --- | --- |
| `CAMADA_KEY` | Required. `<ingest_token>.<snap_token>`, shown once when a project is created. Unset, the SDK is inert and logs one rate-limited error. |
| `CAMADA_INGEST_URL` | Ingest origin. Defaults to production. Local dev: `http://localhost:8787`. |
| `CAMADA_SNAPSHOT_URL` | Blocklist snapshot URL. Defaults to ingest + `/snapshot`. |
| `CAMADA_TRUSTED_PROXY` | `none \| vercel \| hops:N \| cidrs:a,b`. Overrides the project setting locally. Raw X-Forwarded-For is never trusted without it. |
| `CAMADA_DISABLED` | `1` switches the SDK off. Checked per request. |
| `CAMADA_SERVERLESS` | `1` uses lazy snapshot refresh with no interval timer (in-app SDKs). Cold invocations fail open and catch up. |
| `CAMADA_CHALLENGE` | `0` passes challenge verdicts instead of serving the proof-of-work page (in-app SDKs). |

Agents

## For AI agents and coding assistants

- [llms.txt](https://www.camada.app/llms.txt) lists every page with a one-line summary. [llms-full.txt](https://www.camada.app/llms-full.txt) is the whole site in one file.
- Every page has a Markdown version at its URL plus `.md`, for this page [/docs.md](https://www.camada.app/docs.md). The page's own URL returns the same Markdown when the request sends `Accept: text/markdown`.
- An [agent skill](https://www.camada.app/.well-known/agent-skills/add-camada/SKILL.md) holds the install steps for every framework, listed in the [skills index](https://www.camada.app/.well-known/agent-skills/index.json).
- The app's API is described in [OpenAPI 3.1](https://my.camada.app/api/openapi.json) and listed in the [API catalog](https://www.camada.app/.well-known/api-catalog).
- [robots.txt](https://www.camada.app/robots.txt) lets in search engines, AI answer engines and AI training crawlers that say who they are.

## Sitemap

[Every page on this site](https://www.camada.app/sitemap.md)