Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

This plugin enables users to display the geolocation informaton, such as country, region, city, derived from the IP addresses.


  1. Install Geo::IP2Location libraries from CPAN.

  2. Upload to /usr/share/awstats/plugins.

  3. Open /etc/awstats/awstats.conf and insert following line:

     LoadPlugin="ip2location /usr/share/IP2Location/IP2LOCATION-LITE-DB1.BIN"

    **Note: ** Make sure the path to IP2Location database file is correct.

  4. Disable any Maxmind GeoIP plugin as AWStats hook can only access by one plugin per time.

  5. View the information by accessing "Countries" or "Hosts" from the left menu.


It's recommended to use IP2Location DB3 which included country, region, and city information.

IPv4 BIN vs IPv6 BIN

Use the IPv4 BIN file if you just need to query IPv4 addresses.

Use the IPv6 BIN file if you need to query BOTH IPv4 and IPv6 addresses.