Configuration

Everything lives under the geolocator config key; the values below can be set in config/geolocator.php or through the environment.

Environment variable	Default	Description
GEOLOCATOR_DRIVER	iplocationdb	Driver used by the manager
IPLOCATIONDB_COUNTRY_DB_PATH	storage/app/geolocation/GeoLite2-Country.mmdb	Country edition, IPv4
IPLOCATIONDB_COUNTRY_DB_PATH_V6	storage/app/geolocation/GeoLite2-Country-IPv6.mmdb	Country edition, IPv6
IPLOCATIONDB_CITY_DB_PATH	storage/app/geolocation/GeoLite2-City.mmdb	City edition, IPv4
IPLOCATIONDB_CITY_DB_PATH_V6	storage/app/geolocation/GeoLite2-City-IPv6.mmdb	City edition, IPv6
IPLOCATIONDB_ASN_DB_PATH	storage/app/geolocation/GeoLite2-ASN.mmdb	ASN edition, IPv4
IPLOCATIONDB_ASN_DB_PATH_V6	storage/app/geolocation/GeoLite2-ASN-IPv6.mmdb	ASN edition, IPv6
MAXMIND_AUTO_UPDATE	true	Register the update command on the schedule
MAXMIND_UPDATE_FREQUENCY	weekly	hourly, daily, weekly, monthly, or a cron expression

Two things are worth knowing about the paths:

• Each edition has a separate IPv4 and IPv6 file, and the driver picks between them from the address it was given. An IPv6 address therefore needs the *_PATH_V6 file even if every IPv4 lookup works.
• The defaults sit under storage/app/geolocation, which the update command also writes to. If that path is read-only in production, point these variables somewhere writable — see Installation.

Licensing

The databases are GeoLite2 data redistributed by the ip-location-db project; review that project's licensing and attribution terms before redistributing the files yourself.

The package itself is MIT licensed.