Reference

Geo databases

What they are and why you need them

When a visitor arrives, the tracker only sees an IP address. A geo database turns the IP into facts: the country, region and city, the provider (ISP) and network (ASN), whether the IP belongs to a data center, a VPN or a proxy.

Without one:

So install a database before your first campaign. It takes a minute.

Which databases exist

DatabaseGivesCostWhat you need
Sypex Geo City LiteCountry, region, cityFreeNothing β€” one click
MaxMind GeoLite2 City + ASNCity, provider and ASNFreeA free MaxMind account: Account ID + License key
IP2Location LITE DB11Country, city, coordinates, ZIP, time zoneFreeA free IP2Location account: download token
IP2Location ASN LITEProvider / networkFreeThe same token
IP2Proxy LITE PX12VPN, proxy, Tor, data center, residential, fraud scoreFreeThe same token
Paid versions (IP2Location DB4, IP2Proxy PX12 commercial, MaxMind GeoIP2…)Better accuracyPaidUpload the file manually

Recommended set: Sypex (country) + MaxMind GeoLite2 ASN (providers) + IP2Proxy PX12 (VPN/proxy). With it, every cloaking layer works.

The banner on the dashboard

BannerMeaning
No geo database installedNothing is installed β€” install Sypex now
Only the basic Sypex Geo database is connectedCountries work, but cloaking has no provider, data-center or VPN data. Add MaxMind and IP2Location
No geo database installed
No geo database installed
Only the basic database
Only the basic database

How to install

Sypex (one click)

Press Install Sypex Geo (free) on the banner, or βš™ β†’ Geo Databases β†’ Update in the Sypex row. The installer also does it on a fresh server.

MaxMind GeoLite2

  1. Register at maxmind.com (free).
  2. In your MaxMind account: Manage License Keys β†’ Generate new license key. Note the Account ID and the key.
  3. βš™ β†’ Geo Databases: paste MaxMind Account ID and MaxMind License Key, press Save Keys.
  4. Press Update in the GeoLite2 City and GeoLite2 ASN rows.

IP2Location / IP2Proxy

  1. Register at lite.ip2location.com (free).
  2. Copy the download token from your account.
  3. Paste it into IP2Location Download Token, Save Keys, then Update in the DB11, ASN LITE and PX12 rows.
The Geo Databases page
The Geo Databases page

Each row shows Status, the date of the last update and the size. A database that failed to download shows the error.

Your own file

Upload database file accepts .dat, .bin, .mmdb or a .zip with one of them β€” for paid databases or a server without internet.

Updates

Databases are refreshed monthly by a background job (cli/geo_update.php, installed automatically). MaxMind and IP2Location update only when their keys are saved. Update in a row refreshes it right away.

Checking

Geo profiles

βš™ β†’ Geo profiles are named country lists β€” EU, CIS, Tier 1, or your own. Insert them into country filters with one click instead of typing 27 countries.

Reference: Administration β†’ Geo databases, Cloaking.

← Previous
Glossary of abbreviations
Next β†’
AI assistant (MCP)
View source on GitHub: github.com/fenjo26/Orbitra.link/wiki
All guides
Reference

Metrics cheat sheet

Every report column in Orbitra with its formula: CR, CPC, CPA, ROI, ePC and more.

Read guide β†’
Reference

Glossary of abbreviations

Affiliate marketing terms and abbreviations explained in plain words.

Read guide β†’
Reference

Geo databases

Install Sypex Geo, MaxMind and IP2Location, and why better geo data improves cloaking.

Read guide β†’
Reference

AI assistant (MCP)

Connect Claude or another AI assistant to your tracker via MCP and manage it in plain words.

Read guide β†’