...✓Local previewAlpha

Try local auth in about a minute

Start a project-local Zitadel runtime, scaffold a Next.js auth flow, and prove registration and login in your browser before touching Cloud or a dashboard.

Local preview quickstart

Run these in your app, then open /login.

$npx @zitadel/cli@alpha doctor
$npx @zitadel/cli@alpha start
$npx @zitadel/cli@alpha setup --framework next --server local
$npm run dev
Alpha setup pathsNext.jsReactVueAngularNuxtSpring BootDjangoLaravelGoRails.NET- broader framework support comes later

How it works

From empty directory to browser proof

This preview is local-first. Cloud setup, claim, and production handoff are coming later.

1

Check your environment and start local Zitadel

Run npx @zitadel/cli@alpha doctor, then npx @zitadel/cli@alpha start. The runtime stays project-local in .zitadel/local, including metadata and data files.

$npx @zitadel/cli@alpha doctor
$npx @zitadel/cli@alpha start
Local Zitadel runtime is ready.
(server: localhost:8080)
2

Wire the app

Run npx @zitadel/cli@alpha setup --framework next --server local. Next.js is the golden path today, with React, Vue, Angular, and Nuxt adapters available as alpha setup paths.

3

Prove it in the browser

Start the app with npm run dev, open /login, register, log out, and log in again. Username/password and passkeys work in the local preview.

localhost:3000/register
No users yet — you'll be the first. Register to test your auth flow.

Create your account

Already have an account? Log in

What's included

What is actually in this preview

This alpha is intentionally narrow: a runnable local runtime, a Next.js-first setup flow, early framework adapters, and browser-verifiable authentication.

Available in this release

Local runtime

Alpha

Start a project-local Zitadel runtime with no source checkout, dashboard setup, or Cloud account.

Next.js golden path

Alpha

Scaffold a fresh app or wire an existing one with setup --framework next --server local.

Alpha adapters

Alpha

React, Vue, Angular, and Nuxt adapters use the same local auth loop while the API hardens.

Password and passkey auth

Alpha

Register, log out, and log back in through the generated /login flow.

JSON CLI output

Alpha

Use --non-interactive --json when setup needs to be parsed by scripts or agents.

Coming next

Zitadel Cloud setup

Coming soon

Cloud connection and production handoff are coming after the local preview loop is solid.

Claim and handoff

Coming soon

Ownership transfer from local development to a managed organization is future direction.

Schema and flow files

Coming soon

First-class local authoring for user schema and flow configuration is not in this release yet.

Enterprise protocols

Coming soon

OIDC hardening, SSO, SCIM, and governance paths will build on the same developer entrypoint.

Broader stacks

Coming soon

More backend and frontend frameworks come after the current alpha adapters.

Agent delegation

Coming soon

Delegated flows for human, machine, and AI agent use cases are part of the longer direction.

See exactly what ships in this release and what's on deckRead the full announcement

Cloud handoff

coming next

Local first now, managed path next.

The current preview does not connect to Zitadel Cloud and does not include a claim command. Join the waitlist if you want to test Cloud setup, ownership handoff, and production workflows as they land.

Preview

Does the local preview hold up?

We built this for the community to test. It is deliberately early: local runtime, Next.js setup, alpha adapters, passkeys, and username/password. Cloud integration, claim and handoff, enterprise protocols, schema and flow files, and broader stacks are coming next.

Blog PostGitHub DiscussionDiscord Community