PHPackages ip2location/ip2location-piwik - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Database & ORM](/categories/database) 4. / 5. ip2location/ip2location-piwik ActivePlugin[Database & ORM](/categories/database) ip2location/ip2location-piwik ============================= Use the IP2Location geolocation service to lookup your visitors' locations. You can configure the settings under System → IP2Location. 5.5.1(5mo ago)3313317[1 PRs](https://github.com/ip2location/ip2location-piwik/pulls)GPL-3.0-onlyPHPPHP >=7.4 Since Jun 20Pushed 5mo ago8 watchersCompare [ Source](https://github.com/ip2location/ip2location-piwik)[ Packagist](https://packagist.org/packages/ip2location/ip2location-piwik)[ Docs](https://www.ip2location.com/)[ RSS](/packages/ip2location-ip2location-piwik/feed)WikiDiscussions 5.x-dev Synced 2mo ago READMEChangelog (10)DependenciesVersions (49)Used By (0) IP2Location Matomo ================== [](#ip2location-matomo) [![Latest Stable Version](https://camo.githubusercontent.com/75bc7c1b09506542aeb1e57b9ed300cb103d96d3c20eee71e0802b5b645ac223/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6970326c6f636174696f6e2f6970326c6f636174696f6e2d706977696b2e737667)](https://packagist.org/packages/ip2location/ip2location-piwik)[![Total Downloads](https://camo.githubusercontent.com/d1a886b397606d6b13fdcd54cebb31eacc7543e854f6eb482af02676a1cf312d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6970326c6f636174696f6e2f6970326c6f636174696f6e2d706977696b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ip2location/ip2location-piwik) Description ----------- [](#description) This IP2Location plugin enables more accurate location lookup in your Matomo visitor log. You need a IP2Location BIN database to make this plugin works. Database is available for free at or for a commercial database. Installation / Update --------------------- [](#installation--update) 1. Login into your Matomo administrator page. 2. Go to System → Plugins. 3. Click on the **Install New Plugins** button at the bottom of the page. 4. Search for **IP2Location** from the plugin page. 5. Install and activate the plugin. 6. Upload a IP2Location BIN database to **misc** folder. 7. Navigate to **System → IP2Location** page to make sure the BIN database is detected by the plugin. 8. Insert your download token (You can get this in IP2Location Download section). 9. Select your IP2Location Database if you want Matomo to download the BIN database automatically every month. 10. Go to **System → Geolocation**. 11. Select **IP2Location** as provider and save. Configure settings ------------------ [](#configure-settings) You can visit IP2Location Settings by selecting the menu on the left pane (under **System**). This plugin support geolocation lookup using IP2Location BIN file and web service. **To use BIN file, please download it from the below links** - [IP2Location LITE Database (Free)](https://lite.ip2location.com) - [IP2Location Database (Commercial)](https://www.ip2location.com) **To use ip2location.io Geolocation API service, please sign up for the free account at** - How to import the IP2Location BIN file for usage ------------------------------------------------ [](#how-to-import-the-ip2location-bin-file-for-usage) You should copy the BIN file into **/var/www/html/misc** folder (for default installation). If you customize the installation path, it should be the **misc** folder inside your root folder. If you are using Matomo docker image, then you can use below command to copy the BIN into Matomo container. ``` sudo docker cp {YOUR_LOCAL_BIN_FILE_LOCATION} {YOUR_MATOMO_CONTAINER_NAME}:/var/www/html/misc ``` FAQ --- [](#faq) **How to I configure the plugin?** Login as administrator, then go to System → IP2Location. **Where to download IP2Location database?** You can download IP2Location database for free at or commercial version from **Can I use IP2Location.io Geolocation API service?** Yes, please create an account from and insert your API key in the settings page. IPv4 BIN vs IPv6 BIN ==================== [](#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. License ------- [](#license) GPL v3 / fair use Support ------- [](#support) Website: Email: ### Health Score 51 — FairBetter than 96% of packages Maintenance72 Regular maintenance activity Popularity23 Limited adoption so far Community21 Small or concentrated contributor base Maturity76 Established project with proven stability Bus Factor1 Top contributor holds 56.4% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~68 days Recently: every ~152 days Total 46 Last Release 158d ago Major Versions 3.1.22 → 4.0.02020-08-10 4.1.2 → 5.1.02023-11-29 PHP version history (3 changes)3.1.1PHP >=5.3 4.1.0PHP >=7.1 5.3.1PHP >=7.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/d5fbe791b4a8d666a158043146d73380f05a0bea9062f0fa0852bf82f6bc762c?d=identicon)[ip2location](/maintainers/ip2location) --- Top Contributors [![ip2location-com](https://avatars.githubusercontent.com/u/6367210?v=4)](https://github.com/ip2location-com "ip2location-com (137 commits)")[![weblate](https://avatars.githubusercontent.com/u/1607653?v=4)](https://github.com/weblate "weblate (94 commits)")[![chrislim2888](https://avatars.githubusercontent.com/u/3418232?v=4)](https://github.com/chrislim2888 "chrislim2888 (6 commits)")[![sgiehl](https://avatars.githubusercontent.com/u/1579355?v=4)](https://github.com/sgiehl "sgiehl (2 commits)")[![mnapoli](https://avatars.githubusercontent.com/u/720328?v=4)](https://github.com/mnapoli "mnapoli (2 commits)")[![KZeni](https://avatars.githubusercontent.com/u/118200?v=4)](https://github.com/KZeni "KZeni (1 commits)")[![jpbede](https://avatars.githubusercontent.com/u/3989428?v=4)](https://github.com/jpbede "jpbede (1 commits)") --- Tags databasegeolocationip-databaseip-geolocationip-lookupip2locationip2location-piwikmatomogeolocationpiwikip2location ### Embed Badge ![Health badge](/badges/ip2location-ip2location-piwik/health.svg) ``` [![Health](https://phpackages.com/badges/ip2location-ip2location-piwik/health.svg)](https://phpackages.com/packages/ip2location-ip2location-piwik) ``` ### Alternatives [doctrine/orm Object-Relational-Mapper for PHP 10.2k285.3M6.2k](/packages/doctrine-orm)[maxmind-db/reader MaxMind DB Reader API 69799.2M47](/packages/maxmind-db-reader)[mongodb/mongodb MongoDB driver library 1.6k64.0M543](/packages/mongodb-mongodb)[ip2location/ip2location-php \[Official Release\] IP2Location PHP API to get location info from IPv4 and IPv6 address. 2133.9M33](/packages/ip2location-ip2location-php)[lwwcas/laravel-countries A comprehensive package for managing country data in Laravel applications, including multilingual support, geographic coordinates, and detailed metadata for seamless integration with Laravel. 12464.0k](/packages/lwwcas-laravel-countries)[ip2location/ip2location-laravel Lookup for visitor's IP information, such as country, region, city, coordinates, zip code, time zone, ISP, domain name, connection type, area code, weather, MCC, MNC, mobile brand name, elevation and usage type. 83516.9k1](/packages/ip2location-ip2location-laravel) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)