Home

Offline IP geolocation for Laravel — country, city and ASN — backed by local MaxMind databases. Lookups are file reads, so nothing touches the network; only the update command downloads anything.

The package is sameoldnick/laravel-geolocator. Start with the README for the requirements, the installation and a quick start, then come back here for the detail.

Pages

Page	What it covers
Installation	Requirements, publishing the config, downloading the databases, deployment notes
Configuration	Every environment variable, and the licensing of the redistributed data
Usage	Entry points, the four lookups, reading a result, empty results, the geolocate macro
Testing	Geolocator::fake(), mocks and glob patterns, faking a database reader
Custom drivers	Implementing a driver and registering it with the manager
Database updates	The update command, the schedule, the events and the progress callback
Troubleshooting	What throws, what returns an empty result, and the symptoms in between
AI guidelines	The Laravel Boost guideline and skill the package ships