Browse all docs

IP library live updates

Pull the latest IP intelligence snapshot on a schedule with your own dnspup key; nodes use it for country, province, carrier and IDC conditions.

What it solves

Protection rules and analytics by country, province, carrier or data centre all rely on the IP library to tell where a visitor comes from. IP ownership keeps changing, and a stale library means rules that miss or misfire. A control plane comes with a free base IP library at install, which is not refreshed afterwards; with live updates the control plane pulls the latest snapshot from dnspup on a schedule, builds the library locally, and nodes use whichever copy is newer.

Turning it on

IP library live updates is an official, free module built into both editions; pulls use your own dnspup account's quota.

  1. Open System → IP intelligence live updates (dnspup), turn on scheduled pulls and enter the dnspup API address, key and secret.
  2. Set the interval, alignment time and time zone, click Test connection, and save once it shows a snapshot version.
  3. Click Pull now when you need an update immediately; Pull status shows the last check, last success, snapshot version and next pull.

Main settings

SettingWhat it does
Key and secretThe secret is encrypted and shown as a fingerprint; leave empty to keep
Interval (hours)How often to check for a new snapshot
Alignment time, time zoneWhen the interval starts each day
Pull statusNew library built, data unchanged, no new snapshot, or the error

Typical uses

  • L4 protection blocking by country: keep the library updated daily so newly allocated ranges are placed correctly.
  • CC rules limited by carrier or data centre: rules keep working when data-centre addresses change.

Limits and notes

  • When a pull fails or the licence lapses, nodes keep using the library they have.
  • Until a node has loaded a verified library, publishing L4 rules with carrier, IDC or country conditions is refused; it publishes automatically once the library arrives.
  • The base IP library is free and needs no module.