MMM-uptimekuma

MagicMirror² module to get uptime data from an Uptime Kuma status page.

Examples

Installation

Clone this repository in your MagicMirror installation under modules.
Run npm install in the module directory.
Add configuration to config.js

Using the module

To use this module, add the following configuration block to the modules array in the config/config.js file:

var config = {
    modules: [
        {
            module: 'MMM-uptimekuma',
            config: {
                // See below for configurable options
            }
        }
    ]
}

Requirements

Uptime-Kuma must be accessible. Because authentication is required to read anything except status pages, this module reflects a given status page. You must create a status page before this module can read it.

The default status page is named default, and will be used if no slug is given in the config, but even the default status page does not exist until you create it.

Configuration options

Option	Description
`useIcons`	Flag to use icons (`true`) or text (`false`) values for status of monitor. Default: `false` - text values.
`useColors`	Flag to use colors (`true`) for status of monitor Default: `false` - without colors.
`baseUrl`	Base URL of Uptime Kuma install Default: "http://localhost:3001"
`statusPage`	Slug of UptimeKuma status page to display Default: "default"
`headers`	Display the name of each group from the status page? Values are `true`, `false` or `"auto"`. (Auto is equivalent to `true` if there are multiple groups, but `false` for a single group.) Default: `"auto"`
`vertical`	If multiple groups are defined, should they be laid out vertically (`true`) or horizontally (`false`)? Default: `true`
`updateInterval`	Time (in ms) between updates. Note that Uptime Kuma caches status pages for 5 minutes, so updates may take up to 5 minutes to propagate even with a smaller setting. Default: 60000

MikeBishop / MMM-uptimekuma

readme