UniFi Network List Sync

UniFi Network List Sync is a self-hosted web UI for UniFi admins that automates firewall and address group updates from DNS hostnames or static CIDRs, using…

  • Automation
  • Network Services
  • Security
  • Tools & Utilities
UniFi Network List Sync is a self-hosted web UI for UniFi admins that automates firewall and address group updates from DNS hostnames or static CIDRs, using scheduled jobs, multi-resolver DNS lookups, and run-history diffs.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

49/100 Fair

Maintained
79last commit 9 days ago
Popular
123 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
502 GB minimum RAM

Availability: platform listings confirmed today, links checked 17 days ago

GitHub stars
3
Open issues
1
Last commit
2026-11-12
Latest release
v0.2.9
License
MIT
Activity
rising

Checked today - source: GitHub (mstrhakr/go-unifi-network-list-sync)

Resources & Compatibility

Minimum requirements: 2 GB RAM.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install the UniFi CLI tool Open your terminal and run pip install unifi-cli, or use uvx unifi-cli --help if you prefer not to install anything permanently. This gives you the unifi commands that can look up devices and clients on your UniFi network. source
  • Connect your UniFi controller Run unifi config init and enter your controller’s address or domain plus an API key, which is a secret that lets the tool sign in to UniFi. Without this saved connection, commands and the dashboard can’t reach your UniFi network and will ask you to set it up again. source
  • Try the dashboard and check login Run unifi tui to open an interactive dashboard where you can see your network quickly. If it says Connect your controller, your API key is missing or invalid, so choose guided setup to fix the connection before using the tool. source
  • Sync jobs Create jobs for DNS hostnames or static CIDRs, then schedule cron updates to push resolved IPs into UniFi firewall groups. source
  • Deprecation notice The repository README links to a deprecation notice; check it before installing or updating. source

Fetched today - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Where do I configure the UniFi group and address list inputs?

You create a sync job in the web UI. The job stores UniFi credentials, the target group ID, and hostname or CIDR inputs.

How does the app resolve hostname entries?

It resolves hostnames using multiple DNS resolvers.

Can a sync job run immediately or only on a schedule?

A job can be run manually or on a schedule.

What does the app do after resolving the desired address list?

It computes the desired final list and updates the UniFi firewall group. It also stores run history.

Answers sourced from github.com

Community

Collected 48 days ago - public community threads