Skip to content

x86txt/unifi_contrld

UniFi ControlD + Healthchecks.io

Install and persist the ControlD daemon (ctrld) on UniFi OS devices (UCG Fiber / UDM / CloudKey, etc) and report a daily check to Healthchecks.io with:

  • success/failure (exit code)
  • execution time (runtime measurement)
  • persistence across UniFi OS upgrades (everything under /data + on-boot reapply)

Healthchecks Example

This is what you should see: a Started event followed by OK, with a duration shown.

Healthchecks runtime example


Quick Start

Option 1: One-liner remote install (advanced)

Warning

This command downloads and executes code from the internet — review the repository contents before running it.

curl -fsSL https://raw.githubusercontent.com/x86txt/unifi_contrld/main/scripts/install.sh \
  | bash -s -- \
    --host 192.168.1.1 \
    --user root \
    --hc-uuid a1b2c3d4-e5f6-4789-0123-456789abcdef \
    --profile prod

Option 2: Clone and run locally (recommended for first-time use)

git clone https://github.com/x86txt/unifi_contrld.git
cd unifi_contrld

./scripts/install.sh \
  --host 192.168.1.1 \
  --user root \
  --hc-uuid a1b2c3d4-e5f6-4789-0123-456789abcdef \
  --profile prod

Dry-run (prints actions, makes no changes):

./scripts/install.sh \
  --host 192.168.1.1 \
  --user root \
  --hc-uuid <UUID> \
  --profile prod \
  --dry-run

License

MIT


Need professional DevOps or security consulting? Visit secunit.io for remote consulting services.

About

Auto-installation script for the CTRLD System Daemon on Unifi Devices

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Languages