All dispatches/Databases

Free MMDB Database Download (IPv4 & IPv6 Country + ASN): The Keyless GeoLite2 Alternative & Cheap MMDB Guide

Download ipscope Lite, a free MaxMind-compatible MMDB and CSV.gz database (CC BY 4.0) combining IPv4/IPv6 Country and BGP Origin ASN in one file with no API key required—or upgrade to cheap commercial MMDB + Parquet builds from $20/mo.

Why developers are looking for a keyless GeoLite2 alternative

If you have ever built a Docker image, CI/CD pipeline, or self-hosted analytics tool that needs offline IP geolocation and ASN resolution, you have likely run into the friction of legacy free MMDB download workflows:

  1. Account walls and license keys in CI/CD: Downloading MaxMind's GeoLite2 databases requires creating an account, generating a license key, and injecting secret tokens into every container build or cron updater—even for a free Creative Commons dataset.
  2. Splitting Country and ASN across two separate .mmdb files: GeoLite2-Country.mmdb and GeoLite2-ASN.mmdb are distributed as separate binary trees. If your application needs both the visitor's country code (DE) and their BGP autonomous system (AS24940 Hetzner Online GmbH), your process has to memory-map two files and perform two radix-tree lookups per IP.
  3. Collapsing declared registration and physical location: Registration-only country records frequently report a US headquarters country (US) for a subnet that is physically routed and announced in Frankfurt (DE).
  4. Expensive jump to commercial MMDB editions: When teams outgrow a free database and need city coordinates, ISP connection types (residential, mobile, business, hosting), VPN/proxy/Tor detection, or columnar Apache Parquet (.parquet) files, legacy enterprise database licenses can jump from $0 to hundreds or thousands of dollars per month.

We built ipscope Lite (IPScope-Lite-v1)—and our self-serve commercial downloadable MMDB databases starting at $20/mo—to solve all four problems.


Direct, keyless free MMDB & CSV.gz download (ipscope Lite)

ipscope Lite is a production-grade, dual-stack (IPv4 + IPv6) Country + BGP Origin ASN database released under the Creative Commons Attribution 4.0 International (CC BY 4.0) license.

You do not need an account, an API key, or a wrapper binary to download it. Pull the .mmdb or .csv.gz file directly with curl or wget in any Dockerfile, Kubernetes initContainer, or cron script:

# 1. Download the unified IPv4 + IPv6 Country & BGP ASN MMDB v2.0 file (no key required)
curl -fsSL "https://api.ipscope.io/v1/lite/ipscope-lite.mmdb" \
  -o /var/lib/ipscope/ipscope-lite.mmdb

# 2. Or download the gzipped RFC 4180 CSV export
curl -fsSL "https://api.ipscope.io/v1/lite/ipscope-lite.csv.gz" \
  -o /var/lib/ipscope/ipscope-lite.csv.gz

Both endpoints support standard HTTP ETag / If-None-Match conditional requests (304 Not Modified when your local file already matches the latest release) and HTTP Range resume.


ipscope Lite vs. MaxMind GeoLite2: Technical comparison

Featureipscope Lite (IPScope-Lite-v1)MaxMind GeoLite2 (GeoLite2-Country + GeoLite2-ASN)
Price & LicenseFree ($0/mo) — CC BY 4.0 (commercial & open-source use allowed with attribution link)Free — GeoLite2 EULA (requires account registration)
Download authenticationKeyless direct HTTPS URL (/v1/lite/ipscope-lite.mmdb)Requires account + license_key or geoipupdate config
Country + BGP ASN in 1 fileYes — 1 unified .mmdb file contains both geo (geo_country) and network (asn, organization)No — split across GeoLite2-Country.mmdb and GeoLite2-ASN.mmdb
IPv4 + IPv6 coverageUnified 128-bit binary radix tree (ip_version: 6 with IPv4 mapped under ::/96)Unified IPv4 + IPv6 tree per file
Declared vs. physical countryYes — returns country_code, declared_country_code, is_virtual_location, location_type, and confidenceReturns country and registered_country without is_virtual_location or location_type
BGP prefix metadataIncludes network.asn, network.organization, network.bgp_prefix_length, and network.allocation_statusIncludes autonomous_system_number and autonomous_system_organization
Reader compatibilityStandard MaxMind DB v2.0 (maxminddb in Python/Go/Rust, maxmind in Node.js, NGINX ngx_http_geoip2_module)Standard MaxMind DB v2.0

What is inside an ipscope Lite MMDB and CSV record?

Every release of ipscope Lite is compiled from the exact same nightly 03:00 UTC pipeline that powers the ipscope Lookup API and our commercial database editions, projected down to the geo_country and network families.

1. MMDB record structure (ipscope-lite.mmdb)

When you query ipscope-lite.mmdb using any standard MaxMind DB v2.0 reader, reader.get(ip) returns a nested dictionary with geo, network, and meta maps:

{
  "geo": {
    "country_code": "DE",
    "declared_country_code": "US",
    "accuracy_radius_km": 1000,
    "location_type": "physical",
    "confidence": 0.94,
    "is_virtual_location": true
  },
  "network": {
    "asn": 64500,
    "organization": "Example Cloud Infrastructure GmbH",
    "bgp_prefix_length": 24,
    "allocation_status": "bgp_routed"
  },
  "meta": {
    "dataset_version": "2026-11-10",
    "updated_at": "2026-11-10T03:24:51Z"
  }
}

Notice that even in the free Lite edition, ipscope preserves both country_code (where the subnet is physically used) and declared_country_code (where the block is registered in RIR WHOIS), setting is_virtual_location: true when they differ. Read Why Registration Records Lie: Separating Declared and Physical IP Geolocation for why this matters on leased IPv4 blocks and cloud regions.

2. CSV.gz column layout (ipscope-lite.csv.gz)

The .csv.gz export contains non-overlapping leaf CIDR prefixes in ascending address order with 11 columns:

network_cidr,start_ip,end_ip,ip_version,asn,organization,country_code,location_type,geo_confidence,dataset_version,updated_at

Reading ipscope Lite in Python, Node.js, and Go

Because ipscope-lite.mmdb follows the MaxMind DB v2.0 binary format (see how our MMDB radix-tree compiler works), you can open it with standard open-source MMDB libraries in microseconds (5.6 µs p50 in our repo benchmark on M1 Pro).

Python (maxminddb)

import maxminddb

with maxminddb.open_database("/var/lib/ipscope/ipscope-lite.mmdb") as reader:
    rec = reader.get("89.187.175.151") or {}
    geo = rec.get("geo", {})
    net = rec.get("network", {})

    print("Country:", geo.get("country_code"))
    print("Declared Country:", geo.get("declared_country_code"))
    print("Virtual Location?:", geo.get("is_virtual_location"))
    print("Origin ASN:", net.get("asn"), net.get("organization"))

Node.js / TypeScript (maxmind)

import maxmind, { type Response } from 'maxmind';

interface IpScopeLiteRecord extends Response {
  geo?: {
    country_code?: string | null;
    declared_country_code?: string | null;
    is_virtual_location?: boolean;
    confidence?: number;
  };
  network?: {
    asn?: number | null;
    organization?: string | null;
    bgp_prefix_length?: number;
  };
}

const reader = await maxmind.open<IpScopeLiteRecord>('/var/lib/ipscope/ipscope-lite.mmdb');
const res = reader.get('2606:4700:4700::1111');
console.log(res?.geo?.country_code, res?.network?.asn, res?.network?.organization);

When to upgrade from ipscope Lite to a cheap commercial MMDB (Starting at $20/mo)

ipscope Lite is ideal when your service only needs Country + BGP ASN and can display the required CC BY 4.0 attribution link (IP intelligence data powered by ipscope).

When your application needs no attribution requirement, City coordinates & calibrated accuracy radii, ISP connection types (residential, mobile, business, hosting), VPN/proxy/Tor detection with reason_codes, daily/weekly rebuilds, or Apache Parquet (.parquet) files for DuckDB/ClickHouse/Spark, you can upgrade to a commercial edition without changing a single line of your MMDB reader code.

Every commercial ipscope database subscription includes all three file formats (.mmdb + .csv.gz + .parquet), covers IPv4 + IPv6 in a single unified file, includes 1 internal server seat (+20% per additional server up to 10 servers; 10+ cost the same as 10), and has $0 per-lookup fees:

Database EditionMMDB databaseTypeIncluded Intelligence FamiliesMonthly CadenceWeekly CadenceDaily CadenceAnnual (2 Mo Free)
ipscope LiteIPScope-Lite-v1geo_country + network (.mmdb & .csv.gz)Free ($0) (CC BY 4.0)——Free ($0)
IP to CountryIPScope-Country-v1geo_country (no attribution required + .parquet included)$20/mo$25/mo$30/moFrom $200/yr
IP to ASN & Connection (10% bundle discount)IPScope-ASN-v1network + connection (residential, mobile, business, hosting)$36/mo$45/mo$54/moFrom $360/yr
IP to City Geolocation (10% bundle discount)IPScope-City-v1geo_country + geo_city (city, region, postal, lat/lon, timezone, accuracy_radius_km)$63/mo$79/mo$95/moFrom $630/yr
City + ASN + Connection (15% bundle discount)IPScope-City-ASN-v1geo_country + geo_city + network + connection$94/mo$118/mo$141/moFrom $940/yr
Privacy, VPN & HostingIPScope-Anonymous-IP-v1hosting + anonymity (is_vpn, is_proxy, is_tor_exit, is_relay, reason_codes)—$138/mo$165/moFrom $1,380/yr
Complete Mega Database (20% bundle discount)IPScope-Enterprise-v1All 6 families (country, city, asn, company, privacy, abuse)—$250/mo$300/moFrom $2,500/yr

Build a custom field-family MMDB (IPScope-Custom-v1)

Don't need every preset family? Use the Custom Database Builder to compile only the exact field families your workload uses:

  • Country (geo_country): $20/mo
  • City (geo_city, requires Country): +$50/mo
  • ASN (network): +$20/mo
  • Company & Connection (connection): +$20/mo
  • Privacy, VPN & Hosting (anonymity + hosting): +$110/mo
  • Abuse & Scanners (security_extensions): +$50/mo

For example, a custom Country + ASN commercial MMDB (with .parquet included and no CC BY 4.0 attribution requirement) costs just $40/mo ($36/mo if you pick the ASN + Connection bundle). See our full ipscope vs. MaxMind, IPinfo, IPLocate, IPGeolocation & IPScanner comparison for how this compares across providers.


Frequently asked questions (FAQ)

Is ipscope Lite free for commercial products and SaaS applications?

Yes. ipscope Lite (IPScope-Lite-v1) is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0). You can use it in commercial applications, SaaS backends, and open-source projects at zero cost as long as you credit ipscope with a link to https://ipscope.io in your documentation, about page, or footer (see Database Licensing for the exact HTML snippet). If you cannot display attribution, the commercial IP to Country database starts at $20/mo.

Why does ipscope Lite put Country and BGP ASN in one .mmdb file instead of two?

In real-world backend services, almost every lookup that needs an IP's country also benefits from knowing the BGP origin ASN and network operator (network.asn and network.organization). Combining both into one deduplicated binary radix tree means your application only opens one file and walks one tree per lookup.

How do I update .mmdb files in production without crashing live worker processes?

Never overwrite a memory-mapped .mmdb file in place with curl -o, which truncates the active inode and triggers SIGBUS in processes reading it. Download to a temporary staging file in the same directory, verify its SHA-256 digest, and atomically swap the directory entry with mv -f (rename(2)). Follow our step-by-step guide on Zero-Downtime MMDB Hot-Reloads in Go, Rust, and Node.js.

What if I prefer an HTTPS API instead of managing .mmdb files on my servers?

You can query the ipscope Lookup API (GET /v1/ip/:ip and POST /v1/ip/batch), which reads from the exact same nightly build. The Free API plan ($0/mo) includes 30,000 lookups/month with Country, BGP ASN, and 100-IP batch support; paid plans start at $12/mo (Starter, 250,000 lookups/mo) and $39/mo (Pro, 2,000,000 lookups/mo with full VPN, proxy, Tor, and abuse detection). Test any IP right now in the interactive live demo.

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.