Skip to content

Check Your Instance

github-actions[bot] edited this page Nov 22, 2026 · 1 revision

Check your instance

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).

Deploy it

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.migrate label.
  • Mail is off without MAIL_SMTP_URL on the server. With it, the page has a button that sends a test email to WHOAMI_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.

Check backups

Each page view adds a row to whoami's own table, so it has data to back up:

  1. Open the page a few times.
  2. On the app's Backups page, choose Back up now.
  3. Look for whoami/<time>/database.dump in your bucket.
  4. Optionally restore that backup, from the same page: the count on whoami's page goes back.

Afterwards

Remove the app, or keep it as a canary: the dashboard watches its health like any other app.

Clone this wiki locally