From tarball

Uncompress and unarchive the tarball:

tar -zxvf ltb-project-self-service-password-*.tar.gz

Install files in /usr/share/:

mv ltb-project-self-service-password-* /usr/share/self-service-password

You need to install these prerequisites:

  • Apache or another web server

  • php (>=7)

  • php-curl (haveibeenpwned api)

  • php-filter

  • php-gd (captcha)

  • php-ldap

  • php-mbstring (reset mail)

  • php-openssl (token crypt, probably built-in)

  • Smarty (version 3)

Debian / Ubuntu

Configure the repository:

vi /etc/apt/sources.list.d/ltb-project.list
deb [arch=amd64 signed-by=/etc/apt/keyrings/ltb-project.gpg] stable main

Create repository key folder, if it doesn’t exist:

sudo mkdir -p /etc/apt/keyrings

Import repository key:

wget -O - | gpg --dearmor -o /etc/apt/keyrings/ltb-project.gpg

Then update:

apt update

You are now ready to install:

apt install self-service-password

CentOS / RedHat


You may need to install first the package php-Smarty which is not in official repositories.

Configure the yum repository:

vi /etc/yum.repos.d/ltb-project.repo
name=LTB project packages (noarch)

Then update:

yum update

Import repository key:

rpm --import

You are now ready to install:

yum install self-service-password


CentOS 7 comes with PHP 5 by default, you need to install PHP 7.


We provide an official Docker image.

Prepare a local configuration file, for example ssp.conf.php.

<?php // My SSP configuration
$keyphrase = "mysecret";
$debug = true;

Start container, mounting that configuration file:

docker run -p 80:80 \
    -v $PWD/ssp.conf.php:/var/www/conf/ \