# Installation from the tarball

## Get the tarball

Get the tarball from download page and its associated GPG signature file.

## Signature check

Download the Security GPG key and import it:

    gpg --import GPG-KEY-LLNG-SECURITY.asc

Then verify the signature of the tarball:

    gpg --verify lemonldap-ng-*.tar.gz.sig lemonldap-ng-*.tar.gz

## Extraction

Just run the tar command:

    tar zxvf lemonldap-ng-*.tar.gz

## Installation

First check and install the prerequisites.

For full install:

    cd lemonldap-ng-*
    make configure
    make
    make test
    sudo make install PROD=yes

Note

`PROD=yes` makes web interface use minified versions of CSS and JS files.

You can modify location of default storage configuration file in configure target:

    make configure STORAGECONFFILE=/etc/lemonldap-ng/lemonldap-ng.ini

You can choose other Makefile targets:

- Perl libraries install :

  - install_libs (all Perl libraries)

  - install_portal_libs

  - install_manager_libs

  - install_handler_libs

- Binaries install :

  - install_bin (/usr/local/lemonldap-ng/bin)

- FastCGI server install (required for Nginx)

  - install_fastcgi_server (/usr/local/lemonldap-ng/sbin)

- Web sites install :

  - install_site (all sites including install_doc_site)

  - install_portal_site (/usr/local/lemonldap-ng/htdocs/portal)

  - install_manager_site (/usr/local/lemonldap-ng/htdocs/manager)

  - install_handler_site (/usr/local/lemonldap-ng/handler)

- Documentation install :

  - install_doc_site (/usr/local/lemonldap-ng/htdocs/doc)

  - install_examples_site (/usr/local/lemonldap-ng/examples)

You can also pass parameters to the make install command, with this syntax:

    sudo make install PARAM=VALUE PARAM=VALUE ...

Available parameters are:

- ERASECONFIG: set to 0 if you want to keep your configuration files (default: 1)

- DESTDIR: only for packaging, install the product in a jailroot (default: “”)

- PREFIX: installation directory (default: /usr/local)

- CRONDIR: Cronfile directory (default: $PREFIX/etc/lemonldap-ng/cron.d)

- APACHEUSER: user running Apache

- APACHEGROUP: group running Apache

- DNSDOMAIN: Main DNS domain (default: example.com)

- APACHEVERSION: Apache major version (default: 2)

- VHOSTLISTEN: how listen parameter is configured for virtual hosts in Apache (default: *:80)

- PROD: use minified JS and CSS files

- USEDEBIANLIBS: use Debian packaged JS and CSS files (Note that this options isn’t yet usable since Debian provides a too old AngularJS for now: LLNG manager needs at least version 1.4.0)

- USEEXTERNALLIBS: use files from public CDN

- STORAGECONFFILE: make configure target only. Location of default storage configuration file (default: /usr/local/lemonldap-ng/etc/lemonldap-ng.ini)

Tip

For Debian/Ubuntu with Apache2, you can use:

    make debian-install-for-apache
    make ubuntu-install-for-apache

And with Nginx:

    make debian-install-for-nginx
    make ubuntu-install-for-nginx

See also Debian/Ubuntu installation documentation.

## Install cron jobs

LL::NG use cron jobs (or systemd timers) to:

- purge old sessions

- clean Handler cache

To install them on system:

    sudo ln -s /usr/local/lemonldap-ng/etc/cron.d/* /etc/cron.d/

or install .timers files in systemd directory (/lib/systemd/system)

## DNS

Configure your DNS server to resolve names with your server IP:

- auth.<your domain>: main portal, must be public

- manager.<your domain>: manager, only for adminsitrators

- test1.<your domain>, test2.<your domain>: sample applications

Follow the next steps.