Platform Outage
When the platform loses the connection to its database while you are signed in, the web app locks behind a dialog titled Database Connection Lost. Nothing can be read or saved during the outage, so the lock keeps you from clicking through a page that still looks populated but fails on every action. The app rechecks the connection on its own and unlocks as soon as it is back.
The sign-in page has its own warning for the same situation. This page covers the dialog that protects a session already in progress.
When the Dialog Appears
The dialog opens when a request to the platform fails and a follow-up health check reports the database as unhealthy. The health check is what decides, not the failed request: a request that fails for another reason, such as a network problem on your side, does not lock the app.
| Situation | What Happens |
|---|---|
| The database becomes unreachable while you are using the app. | The next failed request triggers a health check, and the dialog opens on top of the page you were on. |
| You reload the page, or open the app in a new tab, while the outage is ongoing. | The app does not send you to the sign-in page. Your session is kept and the dialog is shown while the app waits for the connection to return. |
| The database is healthy but a request fails for another reason. | No dialog. The request shows its usual error message. |
The health check is the same one behind the Database row on the Platform Status page.
What the Dialog Shows
| Element | What It Shows |
|---|---|
| Title | Database Connection Lost, centered at the top of the dialog. |
| Warning | An amber warning card with an icon and the headline Qualytics has lost the connection to its database. The text below it explains that data cannot be read or saved, so the app is locked to prevent further errors, and that work in progress is not recoverable until the connection is restored. |
| Status line | An animated dots indicator followed by Checking automatically and, once a check has completed, the time of the last one. |
| Check Now | The highlighted button. Runs a health check immediately instead of waiting for the next automatic one, and shows a spinner while the check runs. |
| Logout | Signs you out and returns you to the sign-in page. It is unavailable for the moment a manual check is running. |
The dialog cannot be dismissed. Clicking outside it, pressing Esc, or changing the URL leaves it in place. It closes only when the connection is restored or when you log out.
Rechecks and Recovery
While the dialog is open, the app rechecks the connection every 10 seconds and updates the last checked at time after each attempt. Check Now runs the same check on demand. If a check cannot reach the platform at all, the app stays locked and keeps trying; only a check that reports the database as healthy unlocks it.
When the connection returns:
- The dialog closes on its own and a notification appears at the bottom right for a few seconds, with a green icon and the message Database connection restored, captioned You can pick up where you left off.
- You stay on the page you were on. If you had reloaded during the outage, the app finishes loading on that same page.
- Anything you were saving when the connection dropped did not reach the platform. Repeat the action after the dialog closes.
Your Session During an Outage
Sessions are refreshed silently in the background while you use the app. During an outage, a refresh that fails does not sign you out, because the failure is caused by the platform and says nothing about your session. Once the connection is back, sessions behave as usual: a session that had genuinely expired in the meantime ends and returns you to the sign-in page.
Logout works even during the outage. The platform may not be able to record the logout on its side while the database is down, but your browser session is cleared and you land on the sign-in page. That page shows a warning of its own while the outage lasts, Sign-in may be unavailable due to a platform issue, listing the affected component, so you can tell the platform is still down without trying to sign in.
What to Do
Nothing in the app can resolve the outage; the dialog only waits for it to end. The Platform Status page is behind the same lock, so use the dialog's status line or the sign-in page warning to confirm whether the connection is back.
Tip
For managed deployments, the database is managed by Qualytics, so contact the support team. For self-hosted deployments, verify with your infrastructure team that the database service is running and reachable. The Platform Status Troubleshooting page and the Platform Status FAQ cover what an unhealthy database means for the rest of the platform.