Skip to content

linuxserver/docker-mods

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Maxmind Docker mod for Nginx based images

This mod adds the maxmind database to nginx using the license key defined in the environment variable.

This mod downloads the GeoLite2-City.mmdb database under /config/geoip2db, the database is updated weekly.

This mod should not be enabled together with the swag-dbip mod.

Follow these steps to enable the maxmind mod:

  1. Acquire a maxmind license here: https://www.maxmind.com/en/geolite2/signup

  2. In the container's docker arguments, set an environment variable DOCKER_MODS=linuxserver/mods:swag-maxmind

    If adding multiple mods, enter them in an array separated by |, such as DOCKER_MODS=linuxserver/mods:swag-maxmind|linuxserver/mods:swag-mod2

  3. In the container's docker arguments, set the following environment variables:

    • MAXMINDDB_LICENSE_KEY=<license-key> with your license key
    • MAXMINDDB_USER_ID=<user-id> with your user id
  4. Recreate the container to apply the changes.

  5. Add the following line to /config/nginx/nginx.conf under the http section:

    include /config/nginx/maxmind.conf;
  6. Edit /config/nginx/maxmind.conf and add countries to the blocklist / whitelist according to the comments, for example:

    map $geoip2_data_country_iso_code $geo-whitelist {
        default no;
        GB yes;
    }
    
    map $geoip2_data_country_iso_code $geo-blacklist {
        default yes;
        US no;
    }
  7. Use the definitions in the following way:

     server {
         listen 443 ssl;
         listen [::]:443 ssl;
    
         server_name some-app.*;
         include /config/nginx/ssl.conf;
         client_max_body_size 0;
    
         if ($lan-ip = yes) { set $geo-whitelist yes; }
         if ($geo-whitelist = no) { return 404; }
    
         location / {
  8. Restart the container to apply the changes.

About

Documentation and Examples of base container modifications

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages