LDAP Manager

LDAP Manager is a web frontend that allows your users to administrate the their users.

Running

Natively

If you want to run this service without a Docker container, you have to build it yourself.

Prerequisites:

• Go 1.23+
• Node.js v16+
• Corepack (npm i -g corepack)
• templ (go install github.com/a-h/templ/cmd/templ@latest)

You can configure this via a .env.local file or via command options (for more information you can run ./ldap-manager --help).

corepack enable
pnpm i
pnpm build

./ldap-manager \
  `# You can also configure these via environment variables,` \
  `# please see the .env file for available options.` \
  -ldap-server ldaps://dc1.example.com:636 -active-directory \
  -readonly-password readonly -readonly-user readonly \
  -base-dn DC=example,DC=com

Docker

We have a Docker image available here.

You can ignore the warning that the service could not load a .env file.

docker run \
  `# Run the container detached from the current terminal` \
  -d --name ldap-manager \
  `# You might want to mount your host SSL certificate directory,` \
  `# if you have a self-signed certificate for your LDAPS connection` \
  -v /etc/ssl/certs:/etc/ssl/certs:ro \
  -p 3000:3000 \
  ghcr.io/netresearch/ldap-manager \
  `# You can also configure these via environment variables,` \
  `# please see the .env file for available options.` \
  -ldap-server ldaps://dc1.example.com:636 -active-directory \
  -readonly-password readonly -readonly-user readonly \
  -base-dn DC=example,DC=com

Screenshot

Documentation

Comprehensive documentation is available in the docs/ directory:

For Users

• Installation Guide - Setup and deployment instructions
• Configuration Reference - Complete configuration options
• API Documentation - REST API endpoints and usage

For Developers

• Development Setup - Local development environment
• Contributing Guidelines - Code standards and workflow
• Architecture Overview - System design and patterns

For Operations

• Deployment Guide - Production deployment strategies
• Monitoring & Troubleshooting - Operational procedures

Quick Start

For Users

# Docker deployment (recommended)
docker run -d --name ldap-manager \
  -e LDAP_SERVER=ldaps://dc1.example.com:636 \
  -e LDAP_BASE_DN="DC=example,DC=com" \
  -e LDAP_READONLY_USER=readonly \
  -e LDAP_READONLY_PASSWORD=password \
  -e LDAP_IS_AD=true \
  -p 3000:3000 \
  ghcr.io/netresearch/ldap-manager

For Developers

# Setup development environment
make setup
make dev

# See full development guide: docs/development/setup.md

License

LDAP Manager is licensed under the MIT license, for more information please refer to the included LICENSE file.

Contributing

Feel free to contribute by creating a Pull Request!

This project uses Conventional Commits for commit messages and the default gofmt and prettier formatting rules.