Notifications
BadgerPanel includes an in-app notification system for delivering real-time alerts to users. Administrators can broadcast notifications and configure notification behavior.
How Notifications Work
Notifications are delivered in real time via WebSocket. When a notification is created, it appears instantly in the user's notification bell without requiring a page refresh. Users can also receive email notifications for important events if email delivery is configured.
Notification Types
| Type | Description |
|---|---|
| Server | Server status changes (started, stopped, crashed, install complete) |
| Billing | Payment received, invoice due, service suspended |
| Security | New login detected, password changed, 2FA enabled/disabled |
| System | Panel updates, announcements |
| Support | Ticket replies and status changes |
| Info / Success / Warning / Error | General-purpose notification types |
Broadcasting Notifications
Administrators can send notifications to specific users or all users:
- Navigate to Admin > Notifications (or use the broadcast feature).
- Select the target audience:
- All users - broadcast to everyone
- Specific users - select individual recipients
- Fill in the notification details:
- Title - short headline
- Message - notification body
- Type - select the notification type for color-coding
- Action URL - optional link the user can click
- Icon - optional icon
- Click Send.
Automatic Notifications
BadgerPanel automatically sends notifications for key events:
- Server status changes (started, stopped, crashed, installation complete)
- Billing events (payment processed, invoice due, service suspended)
- Security events (new login, password changed, 2FA changes)
- Support ticket replies
These are generated based on user notification preferences.
User Notification Preferences
Users can configure their notification preferences from Account > Notification Preferences:
| Preference | Description |
|---|---|
| Server Alerts | Notifications about server status changes |
| Billing Alerts | Payment and invoice notifications |
| Security Alerts | Login and account security notifications |
| System Announcements | Panel updates and system notifications |
| Support Alerts | Ticket reply and status notifications |
| Email Notifications | Enable/disable email delivery |
| Email Digest | None, daily, or weekly email digest |
Disabled notification types are not created for that user.
Notification Center
Users access their notifications by clicking the bell icon in the header. The dropdown shows the 5 most recent notifications with an unread count badge. Clicking View all notifications opens the full notification page with:
- All notifications with read/unread status
- Mark individual or all as read
- Delete notifications
- Filter by read/unread
Next Steps
- Panel Settings - configure mail for email notifications
- Customization - announcements for panel-wide messages