Installation

From tarball

Prerequisites:

  • php-ldap

  • php-gd

  • composer

  • php-fpm

  • smarty (version 3 or 4)

Tarball can be downloaded from LTB project website.

Uncompress and unarchive the tarball:

tar zxvf ltb-project-white-pages-VERSION.tar.gz

Run composer:

cd ltb-project-white-pages-VERSION/
composer update

Install files in /usr/share/white-pages (or wherever you choose):

mv * /usr/share/white-pages

Adapt ownership of Smarty cache repositories so Apache user can write into them. For example:

chown apache:apache /usr/share/white-pages/cache
chown apache:apache /usr/share/white-pages/templates_c

Debian / Ubuntu

Important

The GPG key for debian has been updated on August 2025. Take care to use the new one by following the instructions below.

Warning

You need to install first the package smarty3. If you face the error syntax error, unexpected token "class", try to install a newer version of the package:

# wget http://ftp.us.debian.org/debian/pool/main/s/smarty3/smarty3_3.1.47-2_all.deb

# dpkg -i smarty3_3.1.47-2_all.deb

Import repository key:

curl https://ltb-project.org/documentation/_static/ltb-project-debian-keyring.gpg | gpg --dearmor > /usr/share/keyrings/ltb-project-debian-keyring.gpg

Configure the apt repository:

vi /etc/apt/sources.list.d/ltb-project.sources

Types: deb
URIs: https://ltb-project.org/debian/stable
Suites: stable
Components: main
Signed-By: /usr/share/keyrings/ltb-project-debian-keyring.gpg
Architectures: amd64

Note

You can also use the old-style source.list format. Edit ltb-project.list and add:

deb [arch=amd64 signed-by=/usr/share/keyrings/ltb-project-debian-keyring.gpg] https://ltb-project.org/debian/stable stable main

Then update:

apt update

You are now ready to install:

apt install white-pages

You should now proceed to webserver installation and configuration

CentOS / RedHat

Warning

You must install the package php-Smarty. You can get it from EPEL repositories.

Configure the yum repository:

vi /etc/yum.repos.d/ltb-project.repo

[ltb-project-noarch]
name=LTB project packages (noarch)
baseurl=https://ltb-project.org/rpm/$releasever/noarch
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-LTB-project

Then update:

dnf update

Import repository key:

rpm --import https://ltb-project.org/documentation/_static/RPM-GPG-KEY-LTB-project

You are now ready to install:

dnf install white-pages

You should now proceed to webserver installation and configuration

Docker

Prepare a local configuration file for White Pages, for example /home/test/whitepages.conf.php.

Start container, mounting that configuration file:

docker run -p 80:80 \
    -v /home/test/whitepages.conf.php:/var/www/conf/config.inc.local.php \
    -it docker.io/ltbproject/white-pages:latest