Appearance
Backup & Restore
EaseLab protects lab data with automated platform backups. Tenant owners can restore their own data; platform admins manage full-platform recovery.
Who can do what?
| Action | Tenant owner | Platform admin |
|---|---|---|
| View tenant backups | Yes | Yes (all tenants) |
| Restore tenant data | Yes | Yes (single-tenant scope) |
| Configure backup schedule | No | Yes |
| Trigger manual platform backup | No | Yes |
| Full platform restore | No | Yes |
View available backups (tenant owner)
- Go to Admin → Backups (tenant portal).
- List shows backups containing your tenant's data:
| Column | Meaning |
|---|---|
| Date | Backup start time |
| Type | Scheduled or Manual |
| Size | Total backup size |
| Expires | Retention expiry date |
API: GET /tenant/backups
Restore tenant data (tenant owner)
DANGER
Restore replaces all current lab data with the backup snapshot. This cannot be undone.
- Select a backup from the list.
- Click Restore.
- Type the confirmation phrase exactly as shown.
- Check I acknowledge data loss checkbox.
- Confirm restore.
API: POST /tenant/backups/{id}/restore
json
{
"confirmation": "RESTORE-MY-LAB",
"acknowledgeDataLoss": true
}Restore runs asynchronously. Do not use the portal until complete.
Platform admin: configure backups
- Admin Portal → Backups → Settings.
| Setting | Recommendation |
|---|---|
| Enabled | true |
| Interval | 1–24 hours based on RPO needs |
| Storage | S3 for production |
| Retention | 7+ days for production |
See Platform Backups.
Platform admin: manual backup
- Admin Portal → Backups → Run Backup Now.
- Monitor status until Completed.
- Verify size and tenant count in manifest.
API: POST /admin/backups
Platform admin: restore scopes
| Scope | Use case |
|---|---|
SingleTenant | One lab corrupted data; others unaffected |
FullPlatform | Complete disaster recovery |
json
POST /admin/backups/{id}/restore
{
"scope": "SingleTenant",
"tenantId": "...",
"confirmation": "RESTORE"
}What is included in a restore?
| Data | Restored? |
|---|---|
| Patients, invoices, results | Yes |
| Test catalog, settings | Yes |
| User accounts (tenant) | Yes |
| Uploaded files (logos, assets) | Yes |
| Platform subscriptions | Only in full platform restore |
Best practices
| Practice | Why |
|---|---|
| Test restore annually | Verify backup integrity |
| Document owner credentials | Required for tenant restore |
| Use S3 off-site storage | Protects against server loss |
| Restore to staging first | Validate before production (if available) |
Troubleshooting
| Issue | Solution |
|---|---|
| No backups listed | Platform backup may not have run; contact admin |
| Restore failed | Check pg_restore on API server |
| Backup stuck Running | Auto-marked failed after 15 minutes |