NGINX Documentation

GeoIP

Create variables based on the client IP address, using the precompiled MaxMind GeoIP databases, for both HTTP and TCP/UDP traffic.

Note MaxMind GeoLite Legacy databases are currently discontinued, MaxMind GeoIP2 or Geolite2 databases and NGINX Plus GeoIP2 module should be used instead.

Installation Instructions

  1. Install the GeoIP module.

    For Amazon Linux, CentOS, Oracle Linux, and RHEL:

    $ yum install nginx-plus-module-geoip
    

    For Debian and Ubuntu:

    $ apt-get install nginx-plus-module-geoip
    

    For SLES:

    $ zypper install nginx-plus-module-geoip
    
  2. Put both of the load_module directives in the top‑level (“main”) context of NGINX Plus configuration file, nginx.conf:

    load_module modules/ngx_http_geoip_module.so;
    load_module modules/ngx_stream_geoip_module.so;
    
    http {
        # ...
    }
    
  3. Perform additional configuration as required by the module (HTTP or TCP/UDP).

  4. Reload NGINX Plus to enable the module:

    $ nginx -t && nginx -s reload
    

More Info