brenard/openldap repository overview

Docker OpenLDAP Directory

This Docker image allows you to quickly deploy a OpenLDAP directory from backups of an existing directory. It is designed for developers and system administrators who need a lightweight, isolated, and reproducible LDAP environment for testing, development, production or CI/CD pipelines.

⁠Key Features

• Automatic Restoration: On startup, the container automatically restores LDAP configuration and data from LDIF backup files (config.ldif and data.ldif).
• Multi-Database Support: Handles multiple LDAP databases, with each database restored from its corresponding backup file (e.g., data.accesslog.ldif).
• Flexible Configuration: Persist OpenLDAP configuration and data across container restarts using Docker volumes.
• Auto-Generated ldapvi Profiles: Simplifies LDAP management by automatically creating ldapvi profiles for each database, accessible via ldapi:///.
• SSL/TLS Support: Automatically manages permissions for SSL/TLS certificates, ensuring secure LDAP connections.
• Multi-Protocol Listening: OpenLDAP listens on ldap:/// (TCP 389), ldapi:/// (Unix socket), and ldaps:/// (TCP 636, if SSL is configured).

⁠Supported Tags

• latest: Based on Debian 13 (Trixie).
• debian11: Based on Debian 11 (Bullseye).
• debian12: Based on Debian 12 (Bookworm).
• debian13: Based on Debian 13 (Trixie).

⁠Source Code

The source code for this Docker image is available on Gitea⁠.

⁠Quick Start

1. Prepare your LDIF backups (config.ldif and data.ldif) in a local directory.
2. Run the container:

   docker run -d \
     --name ldap-dev \
     -v /path/to/backups:/var/backups/ldap \
     -p 389:389 \
     -p 636:636 \
     docker.io/brenard/openldap:latest
   

   Copy
3. Access your LDAP directory:

   ldapsearch -H ldap://localhost -x -b "dc=example,dc=com"
   

   Copy

⁠Use Cases

• Development & Testing: Quickly spin up an LDAP environment for testing applications or scripts.
• CI/CD Pipelines: Integrate LDAP testing into your automated workflows.
• Education & Training: Learn and experiment with OpenLDAP in an isolated environment.

⁠License

This project is licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later).