The Python LDAP packages (python-ldap and pyldap) mostly work on macOS, but if you try to use some options and APIs, you will run into trouble. For example:

The reason for this is that macOS ships with an outdated version of the openldap libraries. To fix it, you will need to build and install a newer version of openldap on your system (as an alternative) and build a version of the Python LDAP libraries that are linked to it.

This is covered for previous versions of macOS in various StackOverflow questions and elsewhere (see links below), but some of the answers may lead you down a bit of a rabbit hole and have you taking unnecessary steps. The steps below will get you going with Python & LDAP with a minimum of hassle.

What you will need:

  • Homebrew
  • Python 3 (or 2.7.x) installed with brew. For this example, I am using Python 3.5.2, but the same steps should work with 2.7.x. Don’t try to do this with macOS’s stock Python.

I’ll be using the pyldap package for this instead of python-ldap. Pyldap is a fork of python-ldap and provides a compatible API with some additional enhancements. The same basic process should work for python-ldap though.

Install OpenLDAP 2.4.x with Homebrew:

Homebrew will install this as a “keg-only” package so it does not conflict with the system version of OpenLDAP.

Clone or download the pyldap sources from Github. E.g.:

cd into the pyldap directory and create a virtual environment (with the version of Python you want to use). For example:


Activate this virtual environment:

Edit the setup.cfg file and add the newer OpenLDAP library and include paths:

Build the package:

At this point, this directory will now contain an updated version of pyldap that you can install in your project’s virtual environment. Just specify the path to it with the pip command:

(with the target Python environment active)

(Optional) Build a Wheel

If you don’t want to keep the LDAP package source code around, you can build a wheel. A Python wheel is a self-contained installation file that includes everything needed for the package you want to install. You could for example, keep this wheel with your project as a resource.

To do this, install the “wheel” package in your virtual environment:

Then build the wheel with:

Look for a “.whl” file in the “dist” directory. You can install this wheel with pip. For example:

(in the target virtual environment)


When you are done building the new pyldap library, remember to deactivate the virtual environment: