Uptime Kuma

A fancy self-hosted monitoring tool based on uptime-kuma.

Basic Links

• Base Project - Uptime Kuma
• PBS GitHub Repository
• Admin
• Status Page PBS

Configuration

Status Page

The status page is publicly accessible at: https://status.scout.ch/

A status page must always have a title, slug, description and footer text.

Goal: service units should have their own status page.

The following status pages are defined:

Tags

Allow to tag monitors for easier filtering.

Goal: standard tags should be used for all monitors.

The following tags are defined:

Monitor Group

Allow to group monitors together for easier viewing.

Goal: service units should have their own monitor group.

The following groups are defined:

How to Add New Monitor

1. Go to the Admin Panel (https://status.scout.ch/dashboard)
2. Click on “Add New Monitor”
3. Fill in the details:
   • Monitor Type: Select the appropriate monitor type (e.g., HTTP(s), TCP, Ping, etc.)
   • Friendly Name: Provide a descriptive name for the monitor
   • URL / Hostname: Enter the URL or hostname to be monitored
   • Monitor Group: Select the appropriate monitor group
   • Tags: Add relevant tags for easier filtering
   • Notification Settings: Configure notification settings as needed, leave default if unsure
   • Notifications: Select the notification methods to be used for this monitor
4. Click “Save” to create the monitor
5. Verify that the monitor is working correctly by checking its status on the dashboard

Notifications

Notifications are sent via two channels: a shared Matrix channel and email.

Matrix

The Matrix channel stays active for all monitors. Every new monitor must have the Matrix notification enabled.

Email

Goal: each recipient group only receives alerts for the services it is responsible for.

Concept:

• For each recipient group, a dedicated email notification target is created in Uptime Kuma.
• All email notification targets use the same sender account no-reply@status.scout.ch on Mailomat (smtp.mailomat.cloud, Port: 587). Credentials for this account are stored in Vaultwarden.
• The notification targets differ only in their recipients (To / CC / BCC).
• A monitor is assigned to the email notification target(s) of the recipient group(s) responsible for it, in addition to the Matrix channel.

How to Add a New Email Notification Target

1. Go to Settings → Notifications in the Admin Panel (https://status.scout.ch/dashboard)
2. Click on “Setup Notification” and select “Email (SMTP)” as notification type
3. Fill in the details:
   • Friendly Name: <Recipient Group> Monitoring (e.g. Who-is-Who Monitoring)
   • Hostname: smtp.mailomat.cloud
   • Port: 587
   • Security: None / STARTTLS (25, 587)
   • Ignore TLS Error: unchecked
   • Username: no-reply@status.scout.ch
   • Password: from Vaultwarden
   • From Email: "Uptime Kuma" <no-reply@status.scout.ch>
   • To Email: recipients of the group
   • Leave “Default enabled” and “Apply on all existing monitors” unchecked
4. Click “Test” to verify that the email is delivered to the recipients
5. Click “Save”
6. Assign the new notification target to the relevant monitors