Troubleshooting

Solutions for common EaseLab issues. Start with the category that matches your problem.

Quick diagnosis

Symptom	Likely cause	Guide
Cannot sign in	Auth, 2FA, or lock	Login & Access
Cannot save anything	Billing lock	Billing & Lockouts
Report won't print	Template or browser	Reports & Printing
Analyzer not importing	API key or barcode	Analyzer Issues
Backup/restore failed	PostgreSQL tools	Backup & Recovery

General steps

1. Note the error message — exact text helps support.
2. Copy the requestId — from API error responses.
3. Check permissions — RBAC.
4. Try another browser — rule out cache/extensions.
5. Check system status — with your platform operator.

Read-only mode

If your lab shows a lock banner, most write operations fail with HTTP 403 and TENANT_READONLY. Go directly to Billing Troubleshooting.

Getting support

Issue type	Contact
Permissions, workflow	Your lab administrator
Billing, subscription	Lab owner → platform billing
Platform outage, backups	Platform support
API integration	Your IT team + API docs

Diagnostic information to collect

Item	How to find
Tenant slug	Settings or URL
User email	Account page
Browser console errors	F12 → Console
API requestId	Network tab or error message
Analyzer logId	Analyzers → Logs

Related resources

Resource	Link
FAQ	General
How-To Guides	Index
Error Codes	API Errors
Glossary	Terms

Troubleshooting guides

• Login & Access
• Billing & Lockouts
• Reports & Printing
• Analyzer Issues
• Backup & Recovery