Install LISA on Linux
We will guide you through the installation of LISA on Linux.
Install Python on Linux
Run following commands to install Python 3.8 in Ubuntu 20.04.
sudo apt update sudo apt install software-properties-common -y sudo add-apt-repository ppa:deadsnakes/ppa -y sudo apt install python3.8 python3.8-dev -y
Install dependencies on Linux
In Linux, for example, on Ubuntu 20.04, please use the command below to install the dependencies:
sudo apt install git gcc libgirepository1.0-dev libcairo2-dev virtualenv python3-pip -y pip3 install virtualenv
git clone https://github.com/microsoft/lisa.git cd lisa
Install Poetry on Linux
Poetry is used to manage Python dependencies of LISA.
Please enter the root folder of LISA source code to run following commands to install poetry, since Poetry manages dependencies by the working folder.
curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/install-poetry.py | python3 -
After running this, you should see
Add export PATH="/home/YOURUSERNAME/.local/bin:$PATH" to your shell configuration file
on the console. Then do
source $HOME/.profile poetry install
lisa.sh is provided in Linux to wrap
Poetry for you to run LISA
In Linux, you could create an alias for this simple script. For example,
add below line to add to
With no argument specified, LISA will run some sample test cases with
the default runbook (
examples/runbook/hello_world.yml) on your local
computer. In the root folder of LISA, you can run this command to verify
your local LISA environment setup. This test will not modify your
FAQ and Troubleshooting
If there’s any problem during the installation, please refer to FAQ and troubleshooting.