Databases · Update Schedule & Zero-Downtime Delivery
Nightly, weekly, or monthly builds with atomic SHA-256 swaps and 30-release rollback
Pull fresh database snapshots automatically from a stable authenticated URL. Conditional ETag headers, HTTP Range resume, and cryptographic checksums make cron and Kubernetes updates effortless.
Daily publish SLA06:00 UTCFresh BGP, geofeed & VPN exit build
Conditional GET304 ETagZero bandwidth when file is unchanged
Signed URLsGCS V4 HMACResumable Range downloads
Archive window30 snapshotsPin or roll back to any releaseId
Daily · Weekly · Monthly
Match your rebuild cadence to how fast your signals change
Country boundaries rarely change overnight, while VPN exit nodes and residential proxy pools rotate continuously. Choose Monthly, Weekly, or Daily rebuilds on any preset or custom database.
- Monthly (Included): Published on the 1st of every month at 06:00 UTC. Ideal for Country and ASN routing analytics.
- Weekly (+$25/mo): Published every Monday at 06:00 UTC. Ideal for City geolocation and ISP classification.
- Daily (+$65/mo): Published every night by 06:00 UTC. Recommended for VPN, proxy, Tor, and fraud prevention.
#!/usr/bin/env bash
set -euo pipefail
DEST="/var/lib/ipscope/ipscope-complete.mmdb"
TMP="$(mktemp /var/lib/ipscope/.ipscope.mmdb.XXXXXX)"
# 1. Download latest release (supports ETag & HTTP Range)
curl -fsSL -H "Authorization: Bearer ${IPSCOPE_DOWNLOAD_KEY}" \
"https://api.ipscope.io/v1/mmdb/releases/latest/download?format=mmdb" -o "$TMP"
# 2. Verify SHA-256 digest before atomic mv
EXPECTED="$(curl -fsSL -H "Authorization: Bearer ${IPSCOPE_DOWNLOAD_KEY}" \
"https://api.ipscope.io/v1/mmdb/releases/latest/checksums?format=text" | awk '/\.mmdb$/ {print $1}')"
echo "${EXPECTED} ${TMP}" | sha256sum -c -
# 3. Atomic POSIX rename (existing mmap readers stay valid)
mv -f "$TMP" "$DEST"Rebuild cadence comparison
Switch cadences at any time from the dashboard or via PATCH /v1/mmdb/licenses/:id.
| Cadence | API Parameter | Publication Schedule | Monthly Add-On | Best For |
|---|---|---|---|---|
| Monthly | every_30_days | 1st of every month at 06:00 UTC | Included ($0) | Country localization, tax compliance, ASN reporting |
| Weekly | weekly | Every Monday at 06:00 UTC | +$25/mo | City geolocation, regional content personalization |
| Daily | daily | Every day by 06:00 UTC | +$65/mo | VPN/proxy blocking, fraud scoring, SIEM threat hunting |
Start with 30K free lookups a month.
No card, no trial clock. Upgrade when your traffic does, or download the database when you would rather keep it in-house.