Choose system →
odysseus admin passwordodysseus login

Odysseus Admin Password

Username is usually admin. The password is printed once on first boot — copy it, then change it in Settings.

30-second answer

Native install: password appears when you run python setup.py, launch-windows.ps1, or ./start-macos.sh.

Docker: docker compose logs odysseus | Select-String -Pattern "password" (PowerShell) or grep -i password.

Windows / native install

After setup finishes, the terminal shows a temporary password line. Screenshot walkthrough: /install/windows.

terminal
python setup.py

Docker install

terminal
# From your odysseus repo folder:

docker compose logs odysseus

# Windows PowerShell — filter for password:
docker compose logs odysseus | Select-String -Pattern "password"

# Mac / Linux:
docker compose logs odysseus | grep -i password

Lost password — reset via auth.json

data/auth.json stores a hash only — you cannot read the old password from it. Moving it aside forces Odysseus to create a new admin on next start.

terminal
# Lost the password? Reset creates a NEW temporary password.
# This does not recover the old one — you get a fresh login.

# 1. Stop Odysseus
docker compose down
# (Native: stop the terminal / uvicorn process)

# 2. Move or delete the auth file (keeps other data if you only remove auth.json)
#    Path is relative to your Odysseus project folder:
mv data/auth.json data/auth.json.bak
# Windows PowerShell:
# Move-Item data\auth.json data\auth.json.bak

# 3. Start again
docker compose up -d
# Native: re-run setup / launch-windows.ps1 / start-macos.sh

# 4. Copy the new temporary password from logs / terminal
docker compose logs odysseus | Select-String -Pattern "password"

First login

  1. Open http://localhost:7000 (Docker / Windows) or http://localhost:7860 (macOS start-macos.sh)
  2. Username: admin
  3. Paste the temporary password from setup or logs
  4. Change password in Settings after first login
First-week checklist
Other troubleshooting
Windows install guide

FAQ

Common questions