Repository navigation
Check Your Instance
github-actions[bot] edited this page Nov 22, 2026
·
1 revision
whoami is a small app that shows what Spotcraft gives an app, and whether each part works. Deploy it after setting up an instance, after an upgrade, or whenever something seems off (ADR 0048).
In the dashboard, choose Add app:
-
Name:
whoami; -
Image:
vindotski/whoami, with the latest tag from its releases; -
Environment:
WHOAMI_MAIL_TO=<your address>, to send a test email.
Then open https://whoami.<apps domain>. Each line is green, amber or off:
-
HTTPS, Environment and Database should always be green. The database line also
shows that the migration ran: whoami's image has the
dev.spotcraft.migratelabel. -
Mail is off without
MAIL_SMTP_URLon the server. With it, the page has a button that sends a test email toWHOAMI_MAIL_TO. In the inbox, open the message's headers ("Show original"): SPF, DKIM and DMARC should pass for your apps domain. - Accounts checks the user pool's public keys.
- Legal facts is amber until you fill in your details on the Settings page.
- Analytics loads the tracker in the browser, following your instance's mode.
Each page view adds a row to whoami's own table, so it has data to back up:
- Open the page a few times.
- On the app's Backups page, choose Back up now.
- Look for
whoami/<time>/database.dumpin your bucket. - Optionally restore that backup, from the same page: the count on whoami's page goes back.
Remove the app, or keep it as a canary: the dashboard watches its health like any other app.
Published from docs/. Edit the files there; changes here are overwritten.