NGINX Documentation


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

    Note: Only 6.x and 7.x versions of CentOS, Oracle Linux, and RHEL are supported.

For Debian and Ubuntu:

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


$ zypper install nginx-plus-module-geoip

For Alpine:

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

    load_module modules/;
    load_module modules/;
    http {
        # ...
  2. Perform additional configuration as required by the module (HTTP or TCP/UDP).

  3. Reload NGINX Plus to enable the module:

    $ nginx -t && nginx -s reload

More Info