First-time setup

A brand-new install has no accounts yet, so the very first thing it shows is a setup screen instead of a login form.

Creating the admin account

Pick a username, email, and password for the one admin account. There's no separate registration flow - once that account exists, everyone after that just signs in with the regular login form at the same address. Setup also seeds one starter dashboard, "Overview", and marks it default - the very first login lands on something real instead of an empty "create your first dashboard" prompt.

Signing in

Athena uses a plain cookie-session login - username/email and password, no separate API key to manage for browser use. A session stays valid until you log out or clear cookies.

API-only installs (ATHENA_HEADLESS=true, see Installation) skip this setup screen and every other UI route entirely - only /api/* is reachable, for installs driven purely by another system.