Create Your First Admin
Create Your First Admin
Section titled “Create Your First Admin”The first admin of a local stack is whoever registers with the owner email you gave seamless init.
There is no invite to create and no admin command to run, and you never need to read container
logs.
Before You Start
Section titled “Before You Start”Make sure:
- your local stack is running (
docker compose up) - you can access the web app at
http://localhost:5173 - you know the email you entered for the owner during
init
How The Owner Grant Works
Section titled “How The Owner Grant Works”init writes your email to the auth server as OWNER_EMAIL. When an account is created with an
address on that list, the auth server grants it admin:write (or admin on an instance whose
available roles list only that).
Email OTP registration creates the account, with the role, before the address is verified, but an unverified account cannot sign in. Only someone who receives the code at the owner address can use it. Signing up through an OAuth provider creates the account from the provider’s verified email.
After the first admin exists, grant admin to other people from the admin console or with
seamless users, not through OWNER_EMAIL.
Step 1: Register With The Owner Email
Section titled “Step 1: Register With The Owner Email”Open http://localhost:5173 and register with the same email you gave init.
Step 2: Enter The Code
Section titled “Step 2: Enter The Code”The local stack sends no email. When the page asks for a code, get one from the project directory:
npx seamless-cli owner-codeIt waits for the auth server, reads the owner address init recorded, and prints a code for it:
Code for admin@example.com: 4K7QZPEnter that code, and enroll a passkey when prompted.
Step 3: Verify The Role
Section titled “Step 3: Verify The Role”After registration, the session’s roles include admin:write alongside the instance’s default
roles (set by DEFAULT_ROLES):
{ "roles": ["<default roles>", "admin:write"]}
Step 4: Open The Dashboard
Section titled “Step 4: Open The Dashboard”Navigate to the admin console. By default your API serves it at:
http://localhost:3000/consoleIf you chose a separate dashboard container during init, it is at http://localhost:5174
instead.

What Just Happened
Section titled “What Just Happened”initrecorded your email as the owner- registration with that email, and the code
owner-codeprinted for it, verified the account - the new account received the admin role at creation
- the admin console became accessible through normal auth state