Skip to content

Install LAVA

Two installation methods are currently supported:

We advice to use docker image for a first test of LAVA.

For a production instance, both methods would be suitable.


In order to install LAVA using the official docker images, we advice to use the provided docker-compose file.


Install the dependencies: docker and docker-compose:

apt-get update
apt-get install python3-pip git
curl -fsSL -o
python3 -m pip install docker-compose
Debian Testing/Sid User

Install instead if the above docker CE installation script doesn't support your distribution.

apt-get install


Get the docker-compose files from gitlab and use it.

git clone
cd docker-compose/
docker-compose pull
docker-compose up

The newly created instance is now available at localhost.


In order to install LAVA using the Debian packages, we advice to use the repositories that we manage to get the latest version.

Supported Debian versions

LAVA is only supported on Debian Buster and Bullseye.


In order to follow this tutorial, you would have to install some dependencies:

apt-get install ca-certificates gnupg2 wget


Add the lavasoftware debian repository:

apt-key add lavasoftware.key.asc
echo "deb buster main" > /etc/apt/sources.list.d/lava.list


Install postgresql and lava debian packages:

apt-get update
apt-get install postgresql
pg_ctlcluster 11 main start
apt-get install lava


Enable default LAVA server Apache configuration:

a2dissite 000-default
a2enmod proxy
a2enmod proxy_http
a2ensite lava-server.conf
service apache2 restart

You can start the different services:

service apache2 start
service postgresql start
service lava-server-gunicorn start
service lava-publisher start
service lava-scheduler start
service lava-worker start

The newly created instance is now available at localhost.