# willswire/unifi-ddns

Cloudflare DDNS (Dynamic DNS) support for UniFi OS

Repository: https://github.com/willswire/unifi-ddns
Canonical: https://ross.abutalabs.com/products/unifi-ddns
Language: TypeScript
License: MIT
License Family: permissive
Topics: cloudflare, cloudflare-workers, ddns, ddns-updater, dns, ubiquiti, unifi, unifi-controller
Last push: 2026-08-26T03:03:11+00:00

## Health v2 (maintenance only)
Score: 90/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 73, longevity 100
- inputs: {"age_days": 1673, "days_push": 7, "days_rel": 183, "gap_med": 22, "n_releases_24m": 8}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1280, forks 3182 (observed 2026-08-28T04:04:13.676100+00:00)

## What it is
A Cloudflare Worker that acts as a Dynamic DNS (DDNS) bridge between UniFi OS gateways (UDM-Pro, USG, etc.) and Cloudflare DNS. It lets UniFi devices update A/AAAA records with their public IP, including multi-hostname, dual-stack, and proxy-status support that native UniFi DDNS lacks.

## Use cases
- keep cloudflare dns record updated with my home ip from a udm-pro
- dynamic dns for unifi when cloudflare is not a built-in provider
- update multiple hostnames from one unifi ddns entry
- ddns that supports both ipv4 and ipv6 on unifi
- preserve cloudflare proxy status when ddns updates the record
- self-hosted services behind a dynamic ip with a unifi gateway

## When to choose
- you want a serverless, click-to-deploy DDNS updater with no server to maintain

## When to avoid
- your UniFi firmware is 9.1.92+ and you only need simple single-hostname, non-proxied updates (native support suffices)
- you use a DNS provider other than Cloudflare
- you cannot or do not want to deploy Cloudflare Workers

## Facets
- artifact type: service
- maturity: active
- function: networking, deployment, developer-tools
- domain: networking, self-hosted, cloud-computing
- platform: cloud, self-hosted
- tags: cloudflare-workers, ddns, dynamic-dns, unifi, ubiquiti, dns-updater, typescript, automation, web-server

## Member repositories
- willswire/unifi-ddns (main) score 90

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:13.676100+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:02:39.575043+00:00, confidence not recorded.
  - readme: https://github.com/willswire/unifi-ddns (fetched 2026-08-28T04:04:13.676100+00:00, sha 5b3a85156706)
- Data as of 2026-08-30T08:39:29.467469+00:00.