A brief description on how to install it

Note that this installation description is for release 1.8.1!

Quick installation


Install in a Python virtual environment:

python3 -m venv /opt/web2ldap
/opt/web2ldap/bin/pip3 install --find-links web2ldap

Start simple stand-alone web server by default listening on localhost, port 1760:

/opt/web2ldap/bin/web2ldap 1760

For remote access to this stand-alone instance you have to explicitly allow access from remote IP addresses by editing configuration option access_allowed in file etc/web2ldap/web2ldapcnf/

For serious use you should use a HTTPS-enabled web server as frontend. See directories etc/apache2/ and etc/uwsgi/ in source distribution for web server integration examples.

Upgrade instructions

If you've customized web2ldap configuration backup your local config changes first:

cp -av /opt/web2ldap/etc/web2ldap /path/to/backupdir/

Then install the web2ldap upgrade (without necessarily upgrading other modules) like this:

/opt/web2ldap/bin/pip3 install --upgrade --upgrade-strategy only-if-needed --find-links web2ldap

Restore your customized web2ldap configuration e.g. from backup or via config management.

Platform-specific instructions