Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
106 lines (71 sloc) 2.45 KB


Join the chat at Build Status


A Varnish 6.0 VMOD to query MaxMind GeoIP2 DB files.

For Varnish 4.1/5.x and master refer to the oldstable and devel branches, respectively.


To build this VMOD you will need:

  • make
  • a C compiler, e.g. GCC or clang
  • pkg-config
  • python-docutils or docutils in macOS [1]
  • varnish-dev in Debian/Ubuntu, varnish-devel in CentOS/RedHat or varnish in macOS [1]
  • libmaxminddb-dev in recent Debian/Ubuntu releases, maxminddb in macOS [1]. See also

If you are building from Git, you will also need:

  • autoconf
  • automake
  • libtool

In addition, to run the tests you will need:

  • varnish

If varnish is installed in a non-standard prefix you will also need to set PKG_CONFIG_PATH to the directory where varnishapi.pc is located before running and configure. For example:

export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig

Finally, to use it you will need one or more GeoIP2 or GeoLite2 binary databases. See


From a tarball

To install this VMOD, run the following commands:

make check
sudo make install

The make check step is optional but it's good to know whether the tests are passing on your platform.

From the Git repository

To install from Git, clone this repository by running:

git clone --recursive

And then run ./ followed by the instructions above for installing from a tarball.


import geoip2;

sub vcl_init {
	new country = geoip2.geoip2("/path/to/GeoLite2-Country.mmdb");

sub vcl_recv {
	if (country.lookup("country/names/en", client.ip) != "Japan") {

More examples available at

DB updates

To update the GeoIP2 DB, download the new file on the same filesystem as the old one and move it over. See also


This VMOD is licensed under BSD license. See LICENSE for details.


  1. Using Homebrew,