System health

One screen that checks every connection, message, background job and setting every day, and tells you in words what to fix.

WhereSettings›Tools›Health

The system checks itself every day and keeps the result. Health shows it: a score, what is working, what to watch and what to fix, with a button beside each problem. It is for admins.

Steps

  1. Open Settings, Tools, Health.
  2. Read the top: Everything is working, Nothing broken; some things to watch, or how many things there are to fix now. Press Check again to run the checks now.
  3. Read Updates. See Install an update.
  4. Go down the checks: Connections, Messages and leads, Background jobs, Size and tidiness, Security and Settings that disagree.
  5. Beside a connection, press Test now to try its key with the service itself.
  6. Beside a problem, press its button (for example Open Connections, Services or Run the cleanup) to go straight to the fix.
  7. Under Size, type what your Supabase plan allows for the database and for file storage, and press Save limits. It warns you well before either fills.
  8. Under Monthly audit, read what it found and tick off What only you can do. Press Run one now for a fresh one.

Good to know

  • Every day at about 6am the system checks itself. If something turns from working to failing, every admin is told once, in the app and by email.
  • On the 1st of each month it writes the audit and tells the admins.
  • When something is failing, a System health line shows under the top bar for admins on every screen.
  • The line also appears if the daily check has not run for two days, because then nothing is watching.
  • Health cannot see your backups, your bills or the security of your own accounts. Those are on the audit checklist, because only you can look.
  • No health information leaves your system.

If something goes wrong

  • "The key for this is not in your project's secrets yet, so there is nothing to test." Paste the key on that service's card under Settings, System, Connections, Services. See Connections overview.
  • "The daily system check has not run for two days." The background clock has stopped. Check Background jobs on the same screen, then contact support.
  • "The system health is for admins." Ask an admin to look.
Still stuck? Tell us what you pressed and what you saw. A person reads every message.
Contact support