web2ldap - Installing

A brief description on how to install it
<Download> <News> <Demo> <Related>
<Commercial> <Feedback> <FAQ>
<Features> <Installing> <Configuration> <Compability> <Security> <Changes> <Files> <Roadmap>

Run modes

web2ldap is designed to be very flexible. It can be installed in two different modes running persistent as a multi-threaded server process under Win32 and Unix platforms:

You can start web2ldap as stand-alone web server running on a specific address (default is fully-qualified hostname) and port (default 1760). You can serve some other static web content in that mode (e.g. the .css files).
If you are running the Apache web server you might want to consider running web2ldap as multi-threaded FastCGIServer under mod_fastcgi.


For running web2ldap 0.10.0+ you need:

  • Python 2.0 or later (current supported and tested version is Python 2.2) built with thread support (configure --with-threads).
  • Module package for web application programming: PyWebLib 1.1.0+.
  • python-ldap
    You have to grab a recent pre-release 2.0.0pre04 and build it against OpenLDAP 2.0.13+ libs.
  • If you want to make use of SRV RR's to automatically locate your LDAP server for a given dc-style DN you have to install PyDNS. (This is rarely needed.)

Web server

Additional web server software depends on the running mode:
Running modeweb serverSSL support
FastCGI server Apache with Apache module mod_fastcgi and the Python module Apache SSL or Apache with mod_ssl
stand-alone built-in requires module M2Crypto

Pre-compiled packages

There are some ready-to-use packages of the required software and web2ldap. Note that the requirements have changed since web2ldap 0.10.x!


Already has packages of OpenLDAP 2, Apache with mod_ssl and mod_fastcgi.
Red Hat
  • Various useful RPM packages for Red Hat 7.2
  • Debian
    Potato includes various packages of Python, OpenLDAP and python-ldap for Python as well as ApacheSSL and Apache with mod_ssl.


    Oddbjorn Steffensen <> maintains a FreeBSD port which you can directly retrieve via CVS from the FreeBSD archive.


    There are currently no OpenLDAP 2 libs for Win32 available. Therefore python-ldap is currently not available on Win32.


    Unix platform

    1. Install all required software on your system.
    2. Extract content of archive web2ldap-*.tar.gz to e.g. /usr/local. Regarding directory names under several Unix flavours: Your mileage may vary.
    3. Rename /usr/local/web2ldap-<version> to /usr/local/web2ldap.
    4. Choose the right script for your running mode and adjust the path to the Python interpreter executable in the first line of the script (see also python -h for usage of option -O and -OO for running with optimized bytecode generation).
      [web2ldapdir]/fcgi/ should reside in a directory which has the right mod_fastcgi directives set for running it as a static FastCGI server.
      Assuming you extracted web2ldap to /usr/local/web2ldap you can configure it as FastCGI server with the following mod_fastcgi directives:
      ScriptAlias /web2ldap-fcgi/ "/usr/local/web2ldap/fcgi/"
      FastCgiServer /usr/local/web2ldap/fcgi/
      <Directory /usr/local/web2ldap/fcgi>
      AddHandler fastcgi-script .py
      The URL for accessing this web2ldap FastCGI server would be


    5. Edit configuration modules under [web2ldapdir]/etc/web2ldap/web2ldapcnf/ which contain comments about every configuration parameter. See also the documentation (which is probably outdated most times ;-).
    6. Change current directory to the directory where you extracted web2ldap and invoke python [web2ldapdir]/sbin/ or python -O [web2ldapdir]/sbin/ for compiling all Python sources.
    7. For a quick start as stand-alone web gateway simply invoke the script [web2ldapdir]/sbin/ which outputs the start URL before detaching from console.

    Win32 platform (stand-alone mode)

    Windows users like it simple. ;-)

    1. Install all required software on your system.
    2. Unpack .tar.gz archive with e.g. recent version of Winzip.
    3. Double-click on [web2ldapdir]\sbin\ for starting web2ldap in stand-alone mode.

    Page last modified: Thursday, 21-Feb-2002 12:10:47 CET, © by Michael Ströder <>