Ldap-Nel

🔐 Modern web interface for LDAP administration

ldapnel-showcase.mp4

✨ Reason

At CBPF, where I work, we use LDAP Admin to make small adjustments to our OpenLDAP server. However, LDAP Admin is a Windows-only tool, which creates issues for team members who use macOS or Linux. To solve this, I developed Ldap-Nel, a web-based application that can be accessed from any platform, anywhere—making LDAP management more accessible and convenient for the whole team.
I also wanted to learn Go 😄

🚀 Setup

1. Install Docker and Docker Compose:
   Follow the official Docker installation guide for your operating system.

2. Create a docker-compose.yaml file:
   Copy the contents from the example into your own docker-compose.yaml.
   or download it

curl -L -o docker-compose.yaml https://raw.githubusercontent.com/dethdkn/ldap-nel/main/docker-compose.yaml
# or
wget -O docker-compose.yaml https://raw.githubusercontent.com/dethdkn/ldap-nel/main/docker-compose.yaml

3. Create a .env file:
   Use the .env.example as a starting point and adjust the values to match your environment.\

curl -L -o .env https://raw.githubusercontent.com/dethdkn/ldap-nel/main/.env.example
# or
wget -O .env https://raw.githubusercontent.com/dethdkn/ldap-nel/main/.env.example

🔑 JWT_SECRET: At least 32 characters
🔐 ENCRYPTION_KEY: This must be a base64-encoded string that decodes to 32 bytes (AES-256).

✅ To generate a valid encryption key run:

openssl rand -base64 32

4. Create the database folder:
   Run the following command to create the required database volume directory (as defined in docker-compose.yaml):

mkdir ./database

5. Pull and start the container:

docker compose pull
docker compose up -d --force-recreate

6. (Optional) Set up a reverse proxy:
   For production use, you can put the Docker app behind an Nginx reverse proxy to serve it on ports 80 or 443.

⬆️ Upgrade

To upgrade ldap-nel to the latest version:

1. Pull the latest image:

docker compose pull

2. Recreate and restart the containers:

docker compose up -d --force-recreate

📝 License

Copyright © 2025 Gabriel 'DethDKN' Rosa
This project is under MIT license