tutorialhomelabself-hostedprivate-workerdocker

Monitoring Self-Hosted Services: Uptime for Your Homelab

M

Monitorion

Monitoring Insights

||6 min read
Share:

The homelab community has embraced self-hosting in a serious way. Home Assistant for automation, Frigate for camera NVR, Pi-hole for DNS-level ad blocking, Plex or Jellyfin for media, Portainer for container management, Nginx Proxy Manager for reverse proxying, Nextcloud for file storage, Bitwarden for passwords. These services are genuinely useful — until they go down unnoticed.

The core challenge: your homelab runs on RFC-1918 private addresses (192.168.x.x, 10.x.x.x). Cloud monitoring services cannot reach these addresses from the public internet. You cannot give UptimeRobot a 192.168.x.x address and expect it to work — and you should not open firewall ports to your internal services just to enable monitoring.

Monitorion's private workers solve this cleanly: a Docker container running inside your network monitors your services locally and pushes results to Monitorion over an outbound HTTPS connection. No inbound ports, no port forwarding, no VPN, no exposure.

Quick Setup (5 minutes)

You need Docker running on any machine in your homelab (your main server, a Raspberry Pi, your NAS if it supports containers). Then:

  1. Create a free Monitorion account at app.monitorion.com
  2. Go to Settings → Private Workers → Add Worker and generate an API key
  3. Run the worker container:
docker run -d   --name monitorion-worker   --restart unless-stopped   --cap-add NET_RAW   -e MONITORION_PLATFORM_URL=https://app.monitorion.com   -e MONITORION_API_KEY=wkr_your_key_here   -e WORKER_NAME=homelab   ghcr.io/monitorion/monitorion-worker:latest

That is it. The worker connects to Monitorion and starts polling for monitoring jobs within seconds.

13 Supported Monitor Types

Private workers support HTTP, Ping, Port, DNS, WebSocket, FTP, SMTP, IMAP, POP3, SSL certificate, domain expiry, heartbeat, and JSON API assertion monitors. Most homelab services are covered by HTTP and Ping checks.

Service-by-Service Setup

Home Assistant

HTTP check: http://192.168.1.x:8123. Add keyword verification for "Home Assistant" to catch cases where the web server responds but the app fails to load.

Frigate NVR

HTTP check: http://192.168.1.x:5000. Frigate's API endpoint returns JSON status — you can use a JSON API assertion monitor to verify specific cameras are online.

Pi-hole

Port check on port 53 (DNS) confirms Pi-hole is accepting DNS queries. HTTP check on the admin panel confirms the web interface is accessible. If DNS drops, every device on your network stops resolving domain names.

Plex / Jellyfin

HTTP check on the media server port (Plex: 32400, Jellyfin: 8096). If your family suddenly cannot watch anything on movie night, you want to know within a minute.

Nginx Proxy Manager

HTTP check on the admin panel (port 81). If NPM goes down, your reverse proxy stops working and all your domain-mapped services become inaccessible.

Portainer

HTTP check on port 9000 or 9443. Portainer is your container management interface — if it is down, you cannot easily manage or restart other containers.

Cameras and Network Devices

Ping monitors for cameras, your main router, secondary access points, and smart home hubs. Simple but effective — you know immediately if a device loses power or network connectivity.

Heartbeat Monitoring for Scheduled Tasks

If you run scheduled backups, data sync scripts, or cron jobs, use Monitorion's heartbeat monitor. Your script pings the heartbeat URL when it completes successfully. If the ping is missed (script failed or did not run), Monitorion alerts you. This works for any scheduled process on any machine in your homelab.

When the Homelab Itself Goes Down

If your home server loses power (or your ISP goes offline), the private worker stops sending heartbeats. Monitorion detects the lost heartbeat within 10 minutes and sends a worker-offline alert. You get notified when individual services fail and when your entire monitoring node goes dark.

Everything on the Free Plan

Monitorion's free plan includes 15 monitors — enough to cover the key services in a well-equipped homelab. The private worker feature is available at every tier including free. No credit card required.

Create your free account and start monitoring your homelab in 5 minutes.

Share:

Enjoyed this post?

Get monitoring tips and product updates delivered to your inbox.


Related Posts