Quick start tutorial

This tutorial will guide you into a minimal installation and configuration procedure. You need some prerequisites:
  • A computer with a GNU/Linux recent distribution (Debian, Ubuntu, CentOS, RHEL, …) with root privileges
  • A web browser
  • The possibility to update your local hosts file, or an easy access to your DNS server
  • A cup of coffee (or tea, we are open minded)

You should install Lemonldap::NG using packages, but you can also install it from the tarball.

apt install apt-transport-https
wget -O - | apt-key add -
echo "deb stable main" > /etc/apt/sources.list.d/lemonldap-ng.list
apt update
apt install lemonldap-ng
curl > /etc/pki/rpm-gpg/RPM-GPG-KEY-OW2
echo "[lemonldap-ng]
name=LemonLDAP::NG packages
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-OW2" > /etc/yum.repos.d/lemonldap-ng.repo
yum update
yum install lemonldap-ng

The defaut SSO domain is You can keep it for your tests or change it, for example for

sed -i 's/example\.com/' /etc/lemonldap-ng/* /var/lib/lemonldap-ng/conf/lmConf-1.json
sed -i 's/example\.com/' /etc/nginx/conf.d/*
sed -i 's/example\.com/' /etc/httpd/conf.d/*
sed -i 's/example\.com/' /etc/apache2/sites-available/*

In order to be able to test, update your DNS or your local hosts file to map this names to the SSO server IP:


For example on your local computer:

echo "" >> /etc/hosts 

Since LemonLDAP::NG 1.2, the demonstration backend is configured by default.

Demonstration backend has hard coded user accounts:

Login Password Role
rtyler rtyler user
msmith msmith user
dwho dwho administrator

Go on and log with one of the demonstration account.

Log with the dwho account and go on