Overview

Zitadel's next-generation preview is the successor track for the platform, built around local-first setup, repo-owned configuration, and auth flows that are easy for humans and coding agents to prove end to end.

Zitadel v4 remains maintained while this preview evolves. The preview is pre-release: APIs, CLI flags, packages, and docs can change before this becomes a future major version. The public product name may also change.

Current shipped boundary

The current shipped path is local auth setup through the @zitadel/cli alpha package:

npx @zitadel/cli@alpha doctor
npx @zitadel/cli@alpha start
npx @zitadel/cli@alpha setup --server local

zitadel start runs the released @zitadel/server npm binary by default. It does not require Docker, Go, Moon, or a source checkout. Docker is still available explicitly with zitadel start --runtime docker.

Create-first, claim-later remains product direction, but zitadel claim is not shipped in this repository yet. Do not build automation or docs around it until the CLI and server contract exists.

What to read first

• Quickstart for the local CLI path.
• Agent setup for --non-interactive --json and browser proof expectations.
• Concepts for project, team, user, local runtime, repo config, flows, schemas, SDK proxy, sessions, and auth attempts.
• CLI for command groups and troubleshooting.
• SDKs for framework package entrypoints.
• API reference for OpenAPI-generated endpoint docs.

LLM support

This docs app exposes:

• /llms.txt for a compact index.
• /llms-full.txt for full text export.
• /*.md for page-level Markdown.
• /api/search for static search.
• /mcp for MCP clients with search, list page, and get page tools.