Installing

A brief description on how to install it

Note that this installation description is for release 1.4.10!

Quick installation

Notes:

Install in a Python virtual environment:

virtualenv -p python2.7 --no-site-packages /opt/web2ldap
/opt/web2ldap/bin/pip2 install --find-links https://www.web2ldap.de/download.html web2ldap

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

/opt/web2ldap/bin/web2ldap 127.0.0.1 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/__init__.py.

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/pip2 install --upgrade --upgrade-strategy only-if-needed --find-links https://www.web2ldap.de/download.html web2ldap

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

Platform-specific instructions