Repository navigation
Checkup
Checkup is where FamilyFi tells you what's worth turning on, fixing or updating. The number next to Checkup in the menu counts the problems waiting for you.

Three built-in rules that most households should turn on once their devices are assigned. They're all off on a new install, so nobody loses internet while you're setting up.
| Protection | What it does |
|---|---|
| Quarantine | New devices stay offline until you assign them. |
| Lock DNS | Keeps the people it covers off other DNS servers, so they can't get around website rules. |
| Block countries | Stops devices reaching servers in the countries you list. |
Turn on all recommended switches on every one that's off, with its usual groups. Edit opens Lock DNS or Block countries to change who it covers. Built-in rules explains each one in full.
FamilyFi reads your UniFi settings and devices about once an hour, and lists anything that could get in the way. Check now looks again straight away. FamilyFi only reads these settings. The one thing it ever removes is a leftover FamilyFi policy, and only when you ask.
Each item says what FamilyFi saw and why it matters. How to fix shows the steps, and some items link to the right page in FamilyFi or to UniFi's own guide. Items come in two kinds:
- Problems are worth fixing.
- Notes may be on purpose, such as a guest network FamilyFi doesn't manage. This is intended (or Dismiss) hides one; Show again brings it back.
What Checkup looks for:
- An old FamilyFi policy is still on your gateway. A policy with a FamilyFi name that none of your rules use, usually left over from an earlier install. Tick the ones to delete and select Remove from gateway, or Keep it. FamilyFi never removes one without you asking.
- A rule was changed in UniFi. Someone edited one of FamilyFi's policies in UniFi. FamilyFi changes it back on its own, and the item shows what was different. If changing it back fails, Put it back tries again.
- Devices use a private Wi-Fi address. They can come back as new, unassigned devices. See private Wi-Fi addresses.
- A network uses its own DNS server. Website rules might not work there. If that server is your Pi-hole or AdGuard Home, you can ignore this.
- Networks FamilyFi doesn't manage. Devices on them get no rules or quarantine. Guest and work networks are often left out on purpose. Change the list on Settings → Gateway.
- Sonos, TVs and printers. Wi-Fi settings that can break Sonos, wired and wireless speakers mixed together, and speakers, TVs or printers your phones can't find because they're on another network.
- Smart-home Wi-Fi. A Wi-Fi network with Things on it that many plugs, bulbs and cameras can't join.
- A new FamilyFi release is ready. Update opens Settings → Maintenance. See Updates and backups.
-
FamilyFi can't follow your update setting. The
FAMILYFI_UPDATE_TAGin your.envisn't one FamilyFi knows. See choosing which releases you get.
Getting started
- Install
- First-time setup
- Family, Things and devices
- Rules, schedules, block and unblock
- Checkup
- Category reports
Phone and Watch
Keeping it running
Links