Configure visitor IP and country lookup
Country lookup uses the bundled IPtoASN IPv4/IPv6 registration-country database locally. No paid service/key or per-visitor outbound request is needed. This release's data snapshot is 2026-10-28. VPNs, proxies, mobile networks and registration data can differ from physical location. Private/unavailable addresses show Unknown.
The default IP comes from PHP's REMOTE_ADDR. If your web server already resolves real visitor IPs, leave Trusted reverse-proxy addresses or CIDRs empty. If PHP sees only a reverse proxy, enter only the actual trusted peer IPs/networks in Xstatics settings. The add-on walks X-Forwarded-For right-to-left through those trusted peers.
Do not trust every address (0.0.0.0/0 or ::/0), copy an unrelated server's proxy range, or blindly accept a country header. For Panelica, inspect its actual isolated web-stack setup rather than modifying host-wide services or guessing which proxy address is used.
After changing trusted peers, use a separate visitor connection and inspect its row. An IP update does not rewrite historical events, which have no raw IP column. Expired live rows are deleted at the next collection/poll/cleanup/cron after the five-minute cutoff. Database updates arrive with an updated package; this release does not download new country files on your server.
We suggest Panelica for managing your hosting environment.
