===== Kallithea =====
<code>
$ sudo apt-get install gcc
$ sudo useradd kallithea
$ sudo mkdir /opt/kallithea
$ sudo chown kallithea.kallithea /opt/kallithea/
$ sudo su - kallithea
$ mkdir /opt/kallithea/var
$ virtualenv --python=/usr/bin/python2.7 /opt/kallithea/
$ source /opt/kallithea/bin/activate
$ pip install --upgrade pip "setuptools<34"
$ pip install kallithea
$ cd /opt/kallithea
$ paster make-config Kallithea my.ini
$ paster setup-db my.ini --user=$USERNAME --password="$PASSWORD" --host="$IPADDRESS" --email=$EMAIL@EMAIL.tk --repos=/home/semaphore
</code>

Configure the repository path to /opt/kallithea/var in the wizard, configure a admin username with password.

Configure HTTPS proxy editing my.ini, adding or uncommenting:
<code>
filter-with = proxy-prefix
[filter:proxy-prefix]
use = egg:PasteDeploy#prefix
prefix = /kallithea
</code>

Start Kallithea:
<code>
$ paster serve my.ini
</code>

Add file to /etc/apache2/sites-available/kallithea.conf:
<code>
<Location /kallithea >
  ProxyPass http://127.0.0.1:5000/kallithea
  ProxyPassReverse http://127.0.0.1:5000/kallithea
  SetEnvIf X-Url-Scheme https HTTPS=1
</Location>
</code>

Enable site and restart:
<code>
$ sudo a2ensite kallithea
$ sudo systemctl restart apache2
</code>

==== Systemd ====
<code>
[Unit]
Description=Kallithea Virtualenv service
After=network.target

[Service]
User=kallithea
Group=kallithea
Environment=VIRTUAL_ENV=/opt/kallithea
Environment=PATH=$VIRTUAL_ENV/bin:$PATH
ExecStart=/bin/bash -c "cd /opt/kallithea; $VIRTUAL_ENV/bin/paster serve my.ini"
Restart=always

[Install]
WantedBy=multi-user.target
</code>

==== IPA LDAP integration ====
If you are using RHEL (sorry I have mixed environments):
<code>
$ sudo yum install openldap-devel
$ source /opt/kallithea/bin/activate
$ pip install python-ldap
$ pip install psycopg2
</code>

==== References ====
  * http://kallithea.readthedocs.io/en/stable/setup.html#setup