documentation:2.0:confignginx
Keywords: documentation,2.0,confignginx

# Deploy Nginx configuration

## FastCGI server

To use Nginx, you must install LemonLDAP::NG FastCGI server or use `llngapp.psgi` (provided in examples) with a PSGI server. See Advanced PSGI usage.

### Debian/Ubuntu

    apt install lemonldap-ng-fastcgi-server

Enable and start the service :

    systemctl enable llng-fastcgi-server
    systemctl start llng-fastcgi-server

### Red Hat/CentOS

    yum install lemonldap-ng-fastcgi-server

Enable and start the service :

    systemctl enable llng-fastcgi-server
    systemctl start llng-fastcgi-server

## Files

With tarball installation, Nginx configuration files will be installed in `/usr/local/lemonldap-ng/etc/`, else they are in `/etc/lemonldap-ng`.

You have to include them in Nginx main configuration.

### Debian/Ubuntu

Link files into `sites-available` directory (should already have been done if you used packages):

    ln -s /etc/lemonldap-ng/handler-nginx.conf /etc/nginx/sites-available/
    ln -s /etc/lemonldap-ng/manager-nginx.conf /etc/nginx/sites-available/
    ln -s /etc/lemonldap-ng/portal-nginx.conf /etc/nginx/sites-available/
    ln -s /etc/lemonldap-ng/test-nginx.conf /etc/nginx/sites-available/

Enable sites:

    ln -s /etc/nginx/sites-available/handler-nginx.conf /etc/nginx/sites-enabled/
    ln -s /etc/nginx/sites-available/manager-nginx.conf /etc/nginx/sites-enabled/
    ln -s /etc/nginx/sites-available/portal-nginx.conf /etc/nginx/sites-enabled/
    ln -s /etc/nginx/sites-available/test-nginx.conf /etc/nginx/sites-enabled/

### Red Hat/CentOS

Link files directly in `conf.d` directory:

    ln -s /etc/lemonldap-ng/handler-nginx.conf /etc/nginx/conf.d/
    ln -s /etc/lemonldap-ng/manager-nginx.conf /etc/nginx/conf.d/
    ln -s /etc/lemonldap-ng/portal-nginx.conf /etc/nginx/conf.d/
    ln -s /etc/lemonldap-ng/test-nginx.conf /etc/nginx/conf.d/