view release on metacpan or  search on metacpan

maxminddb/README.md  view on Meta::CPAN

./configure
make
make check
sudo make install
sudo ldconfig
```

You can skip the `make check` step but it's always good to know that tests are
passing on your platform.

The `configure` script takes the standard options to set where files are
installed such as `--prefix`, etc. See `./configure --help` for details.

If after installing, you receive an error that `libmaxminddb.so.0` is missing
you may need to add the `lib` directory in your `prefix` to your library path.
On most Linux distributions when using the default prefix (`/usr/local`), you
can do this by running the following commands:

```bash
sudo sh -c "echo /usr/local/lib  >> /etc/ld.so.conf.d/local.conf"
ldconfig
```

## From a GitHub "Source Code" Archive / Git Repo Clone (Achtung!)

**NOTE:** These instructions are for installation from the GitHub "Source Code"
archives also available on the
[Releases](https://github.com/maxmind/libmaxminddb/releases) page (e.g.
`X.Y.Z.zip` or `X.Y.Z.tar.gz`), as well as installation directly from a clone of
the [Git repo](https://github.com/maxmind/libmaxminddb). Installation from these
sources is possible but will present challenges to users not comfortable with
manual dependency resolution.

You will need `automake`, `autoconf`, and `libtool` installed in addition to
`make` and a compiler.

You can clone this repository and build it by running:

```bash
git clone --recursive https://github.com/maxmind/libmaxminddb
```

After cloning, run `./bootstrap` from the `libmaxminddb` directory and then
follow the instructions for installing from a named release tarball as described
above.

## Using CMake

We provide a CMake build script. This is primarily targeted at Windows users,
but it can be used in other circumstances where the Autotools script does not
work.

```bash
cmake -B build
cd build/
cmake --build .
ctest -V .
cmake --build . --target install
```

When building with Visual Studio, you may build a multithreaded (MT/MTd) runtime
library, using the `MSVC_STATIC_RUNTIME` setting:

```bash
cmake -DMSVC_STATIC_RUNTIME=ON -DBUILD_SHARED_LIBS=OFF ..
```

We also include a CMake `uninstall` target:

```bash
cmake --build . --target uninstall
```

## On Ubuntu via PPA

MaxMind provides a PPA for recent version of Ubuntu. To add the PPA to your APT
sources, run:

```bash
sudo add-apt-repository ppa:maxmind/ppa
```

Then install the packages by running:

```bash
sudo apt update
sudo apt install libmaxminddb0 libmaxminddb-dev mmdb-bin
```

## On macOS via Homebrew or MacPorts

You can install libmaxminddb on macOS using [Homebrew](https://brew.sh):

```bash
brew install libmaxminddb
```

Or with [MacPorts](https://ports.macports.org/port/libmaxminddb):

```bash
sudo port install libmaxminddb
```

# Requirements

libmaxminddb requires a minimum of POSIX.1-2001 support. If not specified at
compilation time, it defaults to requesting POSIX.1-2008 support.

# Bug Reports

Please report bugs by filing an issue with our GitHub issue tracker at
https://github.com/maxmind/libmaxminddb/issues

# Creating a Release Tarball

Use `make safedist` to check the resulting tarball.

# Copyright and License

Copyright 2013-2026 MaxMind, Inc.