Geolite

[ooCloudXoo]

Is there a more detailed guide on how to use or set up the Geolite feature?

[K0lin]

So first of all, in the docker file or in the .env file you should put:

GEOIP_ENABLED=true #enabled by default

Then you should set the various paths to your geolite files. Not all of them are mandatory; you can just set the ones you want.

GEOIP_CITY_DB=geoip/GeoLite2-City.mmdb #or your custom path; the default path is this
GEOIP_COUNTRY_DB=geoip/GeoLite2-Country.mmdb #or your custom path; the default path is this
GEOIP_ASN_DB=geoip/GeoLite2-ASN.mmdb #or your custom path; the default path is this

There are various ways to install the GeoIP databases.

I quote from the README :

Some community projects (for example, P3TERX/GeoLite.mmdb) provide convenient downloads of GeoLite2 City/Country/ASN files. LogLynx does not ship GeoIP databases and is not responsible for third-party downloads.

If you use third-party downloaders, please ensure you comply with MaxMind's license and, when required, register and accept the license on the official MaxMind site: MaxMind GeoLite2.

To use GeoIP with LogLynx, place the .mmdb files in a directory and mount that directory into the container at the paths configured by GEOIP_CITY_DB, GEOIP_COUNTRY_DB, and GEOIP_ASN_DB.

So that if your folder structure ends up looking like this:

your-folder/
├── traefik/ 
│     └── logs/
│         └── access.log       # Traefik access log
├── geoip/ 
│   ├── GeoLite2-City.mmdb     # optional
│   ├── GeoLite2-ASN.mmdb      # optional
│   └── GeoLite2-Country.mmdb  # optional
└──  docker-compose.yml 

You can safely leave no environment variables in the loglynx configuration because it will take these default values.

If you have any further questions or problems with the configuration, please let me know.