Developers Documentation



301 error for file:

User Tools

Site Tools

Directory Server

The Directory Server app is where you can view and manage your LDAP server settings. If you plan on connecting external applications to access your ClearOS directory, you can control access and find LDAP connection information.


If your system does not have this app available, you can install it via the Marketplace.

You can find this feature in the menu system at the following location:

Server|Directory|Directory Server



The following settings can be configured in the app:

  • The Domain Name should be set to your primary Internet domain, for example
  • The Publish Policy should be enabled if you have external applications accessing the directory

The mode is shown for convenience only – the setting is part of the Account Synchronization app.

Directory Information

General directory information is shown to help you connect external applications to the ClearOS directory.

The bind information and password listed here is critical and sensitive and should be protected.

Accessing the Directory

Webconfig uses the LDAP Directory transparently for many functions. For the most part, adding users, creating groups, setting passwords or changing information about the server will modify the directory in all the ways you need it to without needing to manually enter records.

Modifying data in your LDAP directory can break functionality of ClearOS and make it unsupportable! Please be very careful.

Desktop Graphical Tools

You can use tools like the Apache Directory Studio to browse or change directory information. Use the information shown in the app to connect the client to the ClearOS directory.

Command Line

You can also use command line tools to manage the directory. For these examples we will use the following data:

  • Hostname: localhost
  • Base DN: dc=clearos,dc=lan
  • Bind DN: cn=manager,ou=internal,dc=clearos,dc=lan
  • Bind Password: gbGKD86gEWXLYNRm

A simple search will reveal our entire LDAP directory.

ldapsearch -h localhost -b "dc=clearos,dc=lan" \
-D "cn=manager,ou=internal,dc=clearos,dc=lan" \
-s sub "objectclass=*" -x -w gbGKD86gEWXLYNRm

You can also limit the results to include only specific information. For example, the following show all the groups on the system:

ldapsearch -h localhost -b "dc=clearos,dc=lan" \
-D "cn=manager,ou=internal,dc=clearos,dc=lan" \
-s sub "objectclass=GroupOfNames" -x -w gbGKD86gEWXLYNRm


content/en_us/6_directory_server.txt · Last modified: 2015/08/11 07:57 (external edit)