Skip to content
CloudZH

Docs / Using CloudZH

System Health

One check of the whole server, with repairs you can run by button.

What it checks

CloudZH itself, apps, services, updates and patches, storage, performance, network, versions, backups and the media library. Problems are red and turn the server card red. Notices are yellow.

Failed CloudZH, Docker, SSH, Fail2Ban, WireGuard and network services count as problems. Other Ubuntu services count as notices.

Hiding findings

Every problem, notice or info has a Hide button: until something changes (it returns when the finding gets worse or its title changes), or for 7 or 30 days. Hidden findings do not count for the server state, the sidebar, the assistant or Fix problems. The filter Hidden lists them with a button to show them again. zh doctor always shows everything.

Repairs

Repairs are fixed procedures in the agent, never free commands. Run them by button or on the server:

zh doctor           # check only
zh doctor --fix     # check and run safe repairs
zh doctor --fix --apt   # also repair Ubuntu packages

Self-healing

Every 2 minutes CloudZH repairs safe cases on its own: crashed apps, the dashboard and proxy, important services, time sync, a full disk (unused Docker images only), an expiring certificate and a missing recycle bin in Sonarr, Radarr and Lidarr. A finding has to show up twice in a row first, and nothing happens while an install or update runs. Apps you stopped by hand and hidden findings are left alone. If a repair doesn't help after 3 tries, you get a notification and the finding stays in the list with its button.

The section Self-healing in System Health shows the latest repairs and has the switch to turn it off. On the server:

zh doctor --auto        # status and latest repairs
zh doctor --auto off    # repairs by button only (on: back on)

Security updates

Install security updates runs Ubuntu's own unattended upgrade: security channel only, packages with configuration questions are skipped, nothing is removed and the server does not restart by itself. When a kernel update needs a restart, System Health shows Restart required.

Speed test

Run a speed test with history. CloudZH measures with Cloudflare's speed test by default. The Ookla CLI is optional (zh diagkit ookla on) and licensed for personal, non-commercial use only.