Cool Solution - Joomla

From Univention Wiki

(Redirected from Cool Solution - Joomla 2.5)
Jump to: navigation, search
Produktlogo UCS Version 4.1

Note: Cool Solutions are articles documenting additional functionality based on Univention products. Not all of the shown steps in the article are covered by Univention Support. For questions about your support coverage contact your contact person at Univention before you want to implement one of the shown steps.

Also regard the legal notes at Terms of Service.

This article briefly describes how to install Joomla 3.x, and focuses on how to configure the included LDAP plugin against a UCS LDAP server.

Joomla can be installed on any Linux distribution meeting the requirements, like Debian or Ubuntu.

The Joomla version used to create this article is 3.4.5, and the full package was used (not an update archive).


The following software must be installed in order to run Joomla:

Software Version
Apache >=2.x
PHP >=5.3.10
MySQL >=5.1

MySQL databse

To connect to the MySQL database using PHP, the following PHP extension must be available:

  • MySQL

When Joomla is installed on a UCS system, all dependencies can be installed from the standard UCS repository:

univention-install mysql-server php5-mysql

User prerequisites

In order to log in as a user using the LDAP connection, the mapped attribute for e-mail (see LDAP connection table below) must contain a valid e-mail address.


In this article it is assumed that Joomla will be installed in /var/www/joomla, so the directory must be created first and the ownership must be corrected so the webserver can access the installation folder:

mkdir -p /var/www/joomla
chown -R www-data:www-data /var/www/joomla

Download the latest Joomla version from the Joomla website, and extract it into the newly created directory:

unzip -d /var/www/joomla


The complete configuration of Joomla is managed through the web interface. Please refer to the Joomla manual for assistance.

Joomla configuration

Navigate to https://<SERVER>/joomla/administrator and follow the instructions in the web interface.

Hint: Please note that the administrative user, which is created as first user, is not to be confused with the default UCS administrative user "Administrator".
Hint: Please note that during the configuration, an FTP connection can be configured. The installation and configuration of an FTP is not part of this article.

LDAP configuration

Login is the Joomla administrative user and activate the LDAP plugin by navigating to "Extensions" -> "Manage". A list of available plugins is shown. Activate the LDAP plugin by simply clicking on the button next to "Authentication - LDAP".

Next, navigate to "Extensions" -> "Plugins" and click on "Authentication - LDAP" and configure the plugin accordingly:

Key Value
Host <LDAP server FQDN or IP>
Port 7389
LDAP v3 Yes
Negotiate TLS Yes
Authorisation Method Bind and Search
Base DN <Base DN>
Search string uid=[search]
User's DN uid=[username],cn=users,<Base DN>
Connect Username <Search user's DN>
Connect Password <Search user's password>
Map: Full Name displayName
Map: Email mailPrimaryAddress
Map: User ID uidNumber

Hint: To obtain the base DN, run ucr get ldap/base on any UCS system in the domain.
Hint: It is advised to create a new user for connecting to the LDAP instead of the UCS Administrator user.

UCS overview

To add Joomla to the UCS overview site, set the following UCR variables:

ucr set \
ucs/web/overview/entries/service/joomla/description/de="Joomla CMS." \
ucs/web/overview/entries/service/joomla/description="Joomla CMS." \
ucs/web/overview/entries/service/joomla/label/de="Joomla" \
ucs/web/overview/entries/service/joomla/label="Joomla" \

Hint: When Joomla is not installed on the UCS system, change the UCR variable ucs/web/overview/entries/service/joomla/link accordingly.

Personal tools