Repository navigation
v2.5.0 (Flarum 2.x)
Visitor countries now work out of the box, with no database to download or set up yourself.
If you haven't set a country database file, Birdseye now downloads the free country database from DB-IP by itself and refreshes it once a month. Only the database file is downloaded: no visitor data leaves your server, and every country lookup still happens on your own forum.
- Nothing to configure. The world map and Countries card fill in from the next day processed, as long as Flarum's scheduler is running (Birdseye already needs it for its stats). To fetch the database right away instead of waiting for the next hourly check, run
php flarum birdseye:country-database. - Your own database still wins. If you've already set a MaxMind database file, Birdseye keeps using it and downloads nothing.
- You can turn it off with the new "Download a country database automatically" setting.
- If the download fails (some hosts block outgoing connections), the world map says so and shows the error, and Birdseye keeps whatever copy it already has. It tries again every few hours.
- If it hasn't run yet, the map tells you to check that the scheduler is running.
- The map shows a small "IP Geolocation by DB-IP" credit when DB-IP's database is in use, as its free licence requires.
After updating
Run php flarum cache:clear so your forum serves the rebuilt files instead of the copies it already has cached.