Health checks · a Node64 module

A better Uptime Kuma.
Measured inside. Confirmed outside.

Health checks monitor websites, servers, ports, TLS certificates, cron jobs and Docker containers – right inside your home network and, if you like, from the outside as well, via the ipv64.net locations in Nuremberg and Falkenstein. So you don't just know that something is wrong, but also where.

11 check types Local, online or hybrid Keeps measuring without internet No port forwarding needed
Node64 health check list with groups, states and a countdown to the next measurementNode64 health check list with groups, states and a countdown to the next measurement
Hybrid mode

One check. Two points of view.

A monitor inside your home network only sees the inside. It can't tell you whether your Nextcloud is reachable when you're on the road. In hybrid mode, Node64 runs the check inside while ipv64.net runs the very same check from the outside.

  • The node checks inside: directly in your network, including targets like fritz.box or homeassistant.local.
  • ipv64 checks outside: from Nuremberg and Falkenstein, through your router, DNS and port forwarding – just like your users.
  • The node dials out: outbound and encrypted. You don't open a single port, not even behind DS-Lite or CGNAT.
  • One overall state: you decide when the check counts as down – when all, any or the majority of measuring points report a problem.
 # Your home network                                  # Internet
 ┌──────────────────────────────┐  external checks    ┌──────────────────────┐
 │ Nextcloud                    │◄────────────────────┤ ipv64.net            │
 │ cloud.example.com            │  via router, DNS,   │ Nuremberg location   │
 └──────────────▲───────────────┘  port forwarding    │ Falkenstein location │
                │ checks inside                       └──────────▲───────────┘
 ┌──────────────┴───────────────┐                                ║
 │ Node64                       │════════════════════════════════╝
 │ health checks at home        │   the node opens the connection:
 └──────────────────────────────┘   outbound, encrypted, no open port

Down inside, OK outside

The problem is in your home network, on the node or on the internal path.

OK inside, down outside

Internet uplink, port forwarding, DNS or firewall – the service itself is fine.

Down inside and outside

The service itself is affected. Time to look at the server.

The detail page of every hybrid check shows this diagnosis automatically.

Everything homelab monitoring needs

From a simple ping to a hybrid check with several measuring points – built into Node64, no extra containers required.

Watches itself, too

If your node or your internet goes down, a check doesn't stay green – it turns “Not monitored”. When connected to ipv64.net, you actively get told that it is no longer being checked.

Multiple measuring points

A check can be measured by several nodes and ipv64 locations. Each measuring point gets its own chart; the overall state follows your rule.

Offline-proof

Without internet, the node keeps measuring and alerts through its own channels. It uploads measurements and events later – nothing gets lost.

Docker containers

All containers of the host monitored automatically: “healthy”, restart loops, OOM, CPU and RAM with history – with rules like Proxmox VE. Keep single containers as a check on your status page if you like.

Push for cron jobs

Backups and scripts report in by themselves. The push URL works inside your network (counts even without internet) and online via ipv64.net (reachable from anywhere).

Alerts without the noise

Retries, stabilization, flap detection, summary messages, quiet hours and dependencies make sure one outage means one message.

Maintenance windows

Once, daily, weekly or monthly. Checks keep running but don't alert, and maintenance doesn't count against availability.

History & availability

Charts from one hour up to a year, availability in percent, response times min/avg/max and an incident list across all checks.

IPv4 and IPv6

Check both address families separately in one check. If IPv6 is only missing inside the Docker network, the node doesn't mistake that for an outage of the target.

Cluster

Several nodes sync checks and measurements directly – at home or across networks, even without an ipv64 account. You get notified exactly once – if one node fails, the next one takes over.

API & Prometheus

Everything the UI can do is available through the JSON API with an OpenAPI 3.1 description – bulk actions included. Prometheus and Grafana metrics come on top.

Stays tidy with many checks

Groups, tags, filters, sorting and bulk actions. Plus a countdown to the next measurement and a layout that works on your phone.

Eleven check types for your network

Each type comes with sensible defaults – and the details that actually matter in a homelab.

HTTP(S)

Status codes, method, headers, body, basic auth, redirects – and a warning before the certificate expires.

Keyword

Looks for a term in the response – or alerts when it shows up, such as an error message.

JSON (API)

Checks values in a JSON response, e.g. status == ok or queue < 100 – for APIs, Home Assistant and status pages.

DNS

A, AAAA, MX, TXT and more – via a specific resolver or the authoritative name servers. Also checks that your DynDNS domain points to your IP.

Ping (ICMP)

Packet loss and average latency for routers, switches, NAS boxes and anything with an IP address.

TCP

Opens a connection, optionally sends something and checks the reply, with an optional TLS handshake.

Port

Tells open, closed and filtered apart. It can also make sure a port stays closed – RDP from the outside, for example.

Certificate

Expiry, chain, hostname and days left – also with your own CA and a custom server name (SNI).

WHOIS / RDAP

Warns before your domain expires and checks registrar, name servers or the details of an IP network and AS.

Push / heartbeat

The service reports in by itself. If the call doesn't arrive, the check goes down – perfect for backups and cron jobs.

Docker container

State and Docker health check of a container, straight from the Docker Engine – also through a socket proxy.

All options and defaults in the docs →

States

More than just green and red

Node64 tells you honestly what it knows – and what it doesn't.

OKAll good.
DownFailures beyond the configured retries.
Partially downOnly some measuring points report a problem – for example OK inside, down outside.
Not monitoredNo measuring point has reported for three intervals (at least 5 minutes). Instead of a false green, you see that the state is currently unknown.
Quota used upOnline checks once the daily quota of your ipv64 plan is reached – with a note that measuring resumes at midnight. No flood of alerts per check.
FlappingConstantly switching between OK and down – one message instead of many.
StabilizingReachable again, but not often enough in a row yet.
DependentThe parent check is down, so this one doesn't alert on its own.
Detail page of the Nextcloud check with availability, latency chart and settingsDetail page of the Nextcloud check with availability, latency chart and settings

Detail page “Nextcloud”: availability over 24 hours, 30 days and a year, latency per measurement and every event. Connected to ipv64.net, the Nuremberg and Falkenstein locations and the diagnosis are added.

Notifications

One outage, one message

When your router reboots at 3 a.m., you don't want twenty messages. Node64 tells you what matters – on the channel and in the language you choose.

  • Channels: e-mail (SMTP), Telegram, Discord, Slack, Microsoft Teams, Matrix, ntfy, Gotify, Pushover, webhook and browser. Connected to ipv64.net, you also get e-mail and SMS via ipv64 – no mail server of your own required.
  • Summary message: if three or more checks fail at the same time, you get one message per channel.
  • Quiet hours: at night, only checks marked as critical get through. Afterwards you receive a summary.
  • Dependencies: when the FritzBox is gone, your NAS, Proxmox and Home Assistant stay quiet.
  • Reminders: optionally every N minutes for as long as the outage lasts.
  • No duplicate alerts: together with ipv64.net or in a cluster, exactly one place sends the alert.
Set up notifications
Settings for quiet hours, maximum messages per channel and grouped alertsSettings for quiet hours, maximum messages per channel and grouped alerts

Quiet hours, maximum per channel and grouped alerts – set centrally in the notification settings.

Status pages

Show that everything is up

A public status page for customers, your club or the family – straight from your checks, no second tool needed.

  • Daily bars: 30, 60 or 90 days at a glance, plus availability in percent. One click shows 24 hours, latency and the latest incidents.
  • Always up to date: incidents and maintenance windows appear automatically; you add announcements with updates.
  • Tiles for the wall monitor: large tiles for a wall display, compact for embedding, list as the default – light or dark, English or German.
  • Badges, status.json and feed: SVG badges for READMEs and wikis, JSON for Home Assistant and your own widgets, an Atom feed for incidents.
  • No look behind the scenes: visitors only see display names, state and availability – never targets, IPs, ports or error messages.
  • Your look: your own logo, also as favicon, an accent colour, arranged by your health check groups. Fits everything from phone to 4K monitor.
  • Online right away, your own domain if you like: directly on the node's port or via PROXY64 with certificate, blocklists and country block, via CDN64 even without port forwarding. Optionally with a password.
Set up a status page
Status page “My homelab” in dark mode: partial outage of the internet, groups websites, home network and servers with daily bars and availabilityStatus page “My homelab” in dark mode: partial outage of the internet, groups websites, home network and servers with daily bars and availability

A real status page in the “list” layout: overall banner, announcement and 90 daily bars per service. Yellow is a partial outage, red an outage, blue maintenance.

Node64 health checks and Uptime Kuma

Uptime Kuma is a popular monitor for your own server. Node64 picks up where a single location reaches its limits: the view from the outside.

FeatureNode64 health checksUptime Kuma (typical)
Checks inside your own network
Checks from outside without a second server of your own Nuremberg & Falkensteinsecond instance needed
Same check inside and outside, with diagnosis hybrid modenot out of the box
Alert when the monitor itself goes down “Not monitored”external monitoring needed
Several measuring points per check with a rule all / any / majoritynot out of the box
Keep measuring offline, upload data laterno online counterpart
Push URL inside your network and online bothURL of your own instance
Monitor Docker containers all containers automatically, with CPU/RAM history and rules
Public status pages daily bars, own logo, badges, own domain, password
Maintenance windows
Quiet hours with an exception for critical checksnot out of the box
Summary messages and a cap per channelnot out of the box
Flap detection and stabilizationretries
REST API with an OpenAPI description OpenAPI 3.1no official REST API for monitors
SMS and e-mail without your own server via ipv64.netvia third-party providers
Technologya single Go binary with SQLiteNode.js application
More modules in the same container reverse proxy, DNS filter, DynDNSmonitoring only

Uptime Kuma details reflect common knowledge about a standard installation; features may change with new releases.

Built for the bad day

Monitoring has to work exactly when nothing else does. That's why Node64 runs fully on its own – and the link to ipv64.net is designed to survive outages.

  • Two equivalent ipv64 servers in Germany (Nuremberg and Falkenstein). If one fails, the node switches to the other automatically.
  • Without internet, the node keeps measuring, stores everything locally and notifies through its own channels – an ntfy or Gotify server in your network, for example.
  • Once it's back, it uploads measurements and events without gaps. Late states are filled in quietly at ipv64, without duplicate alerts.
  • Local measurements never count against the health check limit of your account plan – only online measuring points do.
11
check types
2
online locations in Germany
20 s
shortest interval
0
open ports required

Frequently asked questions

No. Local checks, history and notifications work entirely without an account and without internet. For checks from the outside, hybrid mode, e-mail and SMS via ipv64 and the portal, you connect the node to your ipv64.net account. See Connect to ipv64.net for how it works.

No. The node opens the connection to ipv64.net itself – outbound and encrypted. That works behind DS-Lite or CGNAT, too. The only thing you expose is what ipv64.net should check from outside: your service itself.

The node keeps measuring and stores everything locally. It then sends notifications itself through its own channels – ideally one that works without internet, such as ntfy or Gotify inside your network. If the node is connected, ipv64.net notices the outage and tells you that your checks are no longer being checked. Afterwards, the node uploads the missing measurements.

No – private IP addresses, names like fritz.box or .local addresses can't be reached from outside. Your node checks those locally. That's why Node64 rejects private targets for online and hybrid checks right away, and ipv64 won't measure a host name or redirect that points to an internal address either.

No. Only online measuring points count against the health check limit of your account plan. The form shows in advance how many online measurements a check uses per day. Multiple online locations are available from the Supporter plan – see ipv64.net/pricing for the plans.

Yes. Node64 is a single Go binary with SQLite and runs on amd64, arm64 and armv7 – from a mini PC to your NAS to a Raspberry Pi.

The node only reads from the Docker Engine. Still: whoever has the Docker socket can control the host. We therefore recommend a socket proxy that only allows container queries. A ready-made Compose example is in the docs on Docker checks.

Online health checks by ipv64.net

The outside view comes from ipv64.net Healthcheck. Once your node is connected, you see local and online checks side by side – in Node64 and in the ipv64.net portal.

Do you know whether your homelab is reachable from outside right now?

Install Node64, add your first check, optionally connect it to ipv64.net – and from then on you see your network from the inside and the outside.

The public Docker image is coming soon.

Questions about Node64?
For any questions about the product, use the official forum: setup, troubleshooting, ideas and exchange with the community and the ipv64.net team.
Go to the forum v64.tech