selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Monitorr logo

Self-host Monitorr

1.7.6m

Self-hosted service status dashboard with live monitoring

ReleaseOpen SourceMIT
Updated10 hours ago
LanguagePHP
Setup difficultyModerate
MobileResponsive
Stars
675
Port
80 (HTTP web interface)
Requires
PHP, PHP PDO, PHP ZipArchive, Php-curl, SQLite
Docker
monitorr/monitorr
Install with Docker
Monitorr dashboard with multiple servicesMonitorr service status viewMonitorr system resources displayMonitorr settings pageMonitorr service configurationMonitorr mobile responsive view

What is Monitorr?

This PHP-based dashboard lets you watch the health of any network service or web application in real time. It checks endpoints using cURL with a socket fallback, reports response times, and shows host-level metrics such as CPU, memory, disk space, ping latency and uptime. Thresholds for those metrics can be colored to your liking. A built-in settings page handles user registration and login, and you can inject custom CSS or switch update branches from the web UI. The interface works on mobile browsers and has a compact iframe mode for embedding in home-dashboard tools like Organizr. You can run it as a Docker container or drop the files onto any PHP 7-capable web server (nginx, Apache or IIS) with SQLite. The code is MIT-licensed and the last commit was in May 2023.

Should you self-host Monitorr?

Monitorr scores 50/100 on selfhost.directory (how scoring works) and ranks #61 of 104 in Monitoring & observability. It has 675 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in PHP.

Its closest alternative on selfhost.directory is grafana (90/100, 77 569 stars). It scores higher overall, so compare the two before you pick. See Monitorr vs grafana side by side.

Features

  • Custom CSS theming
  • Customizable threshold colors
  • Host system resources monitoring
  • Hotlink control per service
  • Integrated settings with authentication
  • Live service monitoring
  • Minimal iframe UI
  • Multiple check methods
  • Multi-volume disk display
  • Service response time display
  • Web-based update tool

Monitorr README

How to install Monitorr

Install Monitorr with Docker

Docker Engine

docker create
--name=monitorr
--restart=on-failure
-v :/app
-e TZ=
-e PGID=
-e PUID=
-p 80:80
monitorr/monitorr

Data directory automatically established at /app/userdata/ in container

How to configure Monitorr

  • Check TypeStandardMethod to use when checking service (Standard: cURL primary, fsockopen fallback; Ping Only: fsockopen only)

    Method to use when checking service (Standard: cURL primary, fsockopen fallback; Ping Only: fsockopen only)

    values: Standard, Ping Only

  • Check URLAddress of service to check for status (must include protocol, host, and port)

    Address of service to check for status (must include protocol, host, and port)

  • CPU OK color valueCPU% less than this will be green

    CPU% less than this will be green

  • CPU warning color valueCPU% less than this will be yellow

    CPU% less than this will be yellow

  • Custom CSSUser-defined custom CSS to override default styles

    User-defined custom CSS to override default styles

  • EnabledEnable or disable checking of the service

    Enable or disable checking of the service

    values: Enable, Disable

  • HD displayEnable display of multiple volumes (up to 3) in system resources

    Enable display of multiple volumes (up to 3) in system resources

    values: Enable, Disable

  • HD OK color valueHD free % less than this will be green

    HD free % less than this will be green

  • HD VolumeWhich HD volume on the server to display (Windows: 'C:', Linux: '/mnt/hdd')

    Which HD volume on the server to display (Windows: 'C:', Linux: '/mnt/hdd')

  • HD warning color valueHD free % less than this will be yellow

    HD free % less than this will be yellow

  • Link EnabledAttaches Link URL to service tile in the UI

    Attaches Link URL to service tile in the UI

    values: YES, NO

  • Ping color valuesColor values for ping indicators in system resources and service response times

    Color values for ping indicators in system resources and service response times

  • Ping HostURL or IP to ping for RT latency check

    URL or IP to ping for RT latency check

  • Ping host portPing host port to use for latency check

    Ping host port to use for latency check

  • Ping RTEnables PING response time output in the UI for each service

    Enables PING response time output in the UI for each service

    values: Enable, Disable

  • RAM OK color valueRAM% below this is green

    RAM% below this is green

  • RAM warning color valueRAM% below this will be yellow

    RAM% below this will be yellow

  • RegistrationEnableEnable or disable access to the Registration tool

    Enable or disable access to the Registration tool

    values: Enable, Disable

  • Service ImageIcon/image displayed in the UI for the service

    Icon/image displayed in the UI for the service

  • Service & system refresh intervalService & system info refresh interval in milliseconds

    Service & system info refresh interval in milliseconds

  • Service TitleTitle of service displayed in the UI (max 20 chars recommended)

    Title of service displayed in the UI (max 20 chars recommended)

  • Service URLAddress of service exposed via link in the UI (reverse proxy addresses suggested)

    Address of service exposed via link in the UI (reverse proxy addresses suggested)

  • Site TitleText displayed in the header of the UI (15 characters maximum)

    Text displayed in the header of the UI (15 characters maximum)

  • Site URLURL where Monitorr is hosted (should be WAN-accessible if exposed)

    URL where Monitorr is hosted (should be WAN-accessible if exposed)

  • Time Standard12 or 24 hour format

    12 or 24 hour format

    values: True (12hr), False (24hr)

  • Time sync interval180000How frequently the UI clock synchronizes with the hosting webserver (milliseconds)

    How frequently the UI clock synchronizes with the hosting webserver (milliseconds)

  • TimezoneTimezone to use for the UI clock

    Timezone to use for the UI clock

  • Update BranchmasterBranch to use when updating Monitorr (master or develop)

    Branch to use when updating Monitorr (master or develop)

    values: master, develop

Monitorr releases & version history

More in Monitoring & observability

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…