First-time owner setup
A new Cardinal deployment has no owner. The first account to finish setup on the Sign in page becomes the owner, and only once.
Before you start
The person deploying Cardinal sets two things on the server:
OWNER_EMAILS: the owner's email address.OWNER_SETUP_TOKEN: a one-off secret for this setup.
Create the owner account
- Open the Sign in page. While no one owns the workspace, it is titled "Set up Cardinal" and shows a "Setup token" field and a "First-time setup" button.
- Enter the owner email, a password of at least 12 characters, and the setup token.
- Press "First-time setup". Cardinal creates the account, pins it as the owner and signs you in.
If anything is wrong (another email, a short password, a wrong token), the page says "Sign-in failed.", about 10 seconds after you press the button. That's on purpose: the answer looks the same whatever went wrong. Under it the page reminds you that a first-time member opens the invite link in their email and chooses "I already have a Cardinal account".
Afterwards
- Remove
OWNER_SETUP_TOKENfrom the server. Setup can't run again anyway: once an owner exists, the Sign in page hides the setup token and the button, and the server refuses setup. - The Sign in page now says "Welcome back. Sign in with the account from your invite." The owner signs in there with the email and password from setup.
- On the Setup page, name your workspace and yourself. Until you do, Cardinal calls it "My workspace" and uses the first part of your email as your name. Skip it and those stay.
- The Setup page also has "Track your own work on this Mac". It points to Settings › Tracking, sync and data › Sync key and to "Track your own work (Mac collector)".
- Set up your computer from the Setup page, then invite your team from Team › Manage.
Don't turn off sign-up
Keep sign-up turned on in Neon Auth, the sign-in service Cardinal uses. Invites need it: someone accepting an invite creates their Cardinal account through sign-up. With sign-up off, every new invite fails at "Create account and join".
Leaving it on is safe. An account made outside an invite can't open anything: the owner is pinned by account, and everyone else needs an accepted invite for a workspace. You can still turn off sign-in methods you don't use.