🎯 Purpose
Maintenance Mode temporarily “freezes” the application to block changes and integrations during maintenance or fixed time periods.
🔐 Access
Only users with: admin:can_edit_maintenance_mode
Can:
- Set maintenance
- Activate/deactivate maintenance
- Log in during maintenance (limited access)
⚙️ What happens during maintenance?
✅ Allowed
- View data (read-only)
- Approve workflows (unless login is blocked)
❌ Not allowed
- Edit data
- Import/export (ERP)
- Process mailbox & e-invoices
🛠️ Setup
Navigation:Setup → Maintenance Mode
Type
- Once → one-time (start/end time)
- Recurring → fixed days + time blocks
Mandatory
- Description (free text)
- Start date/time
Optional settings
- Block login
- This causes all active sessions to terminate
Default blocks
- Mailbox
- E-invoices
- Import interfaces
- Export interfaces
➡️ Click Save to activate
🔔 Notifications for users
- 1 hour beforehand
- Then: 30, 15, 10, 5, 1 minute
👤 User behaviour
During maintenance
- Read-only access (unless login blocked)
- Pop-up notification visible
- Editing not possible
Login
- Start/end time visible
- If login blocked → no access
- Admin can always log in (maintenance screen only)
🔌 Interfaces
During maintenance:
- ❌ No ERP transactions
- ❌ No imports/exports
- ❌ No backend tasks
⏹️ Manual stop
- Go to Maintenance Mode
- Open active configuration
- Turn off (unfreeze)
✅ Best practices
- Plan outside working hours
- Inform users
- Use recurring for fixed times
- Test in advance
🧾 Summary
Maintenance Mode =
✔ Control over system behaviour
✔ No unwanted changes
✔ Safe standstill of integrations