This guide walks through a self-hosted installation of Kallithea.
Install required packages including Git, Mercurial, and Python dependencies.
sudo apt-get update && sudo apt-get install -y git mercurial python3 python3-pip python3-venv
Set up a Python virtual environment for Kallithea.
python3 -m venv /opt/kallithea/venv
source /opt/kallithea/venv/bin/activate
Install Kallithea using pip.
pip install kallithea
Create the configuration file and initialize the database.
paster make-config kallithea /etc/kallithea/kallithea.ini
paster setup-db /etc/kallithea/kallithea.ini
Run Kallithea with a WSGI server (e.g., gunicorn or uWSGI) behind a reverse proxy.
gunicorn --bind 127.0.0.1:5000 kallithea:app
Prefer automation? See Kallithea Ansible Setup for an example playbook.
Note: Kallithea does not have an official Docker image. Community-maintained images exist (e.g., petergrace/kallithea, domruf/kallithea-docker) but are not officially supported. See Kallithea Docker Setup for community options.
Any questions?
Feel free to contact us. Find all contact information on our contact page.