Installing and Upgrading


There are two ways two install Taurus on Windows. The recommended way is to use the prebuilt installer that will install Python and latest Taurus on your PC. However, if you already have Python installed, you can install Taurus manually with pip, Python package manager.

The installation process was tried on all supported Windows versions (7, 8, 10).

Installing Taurus With Prebuilt Installer

Download an installer and run it on your system. It will install the following components:

  • Python 2.7
  • PyLauncher, needed to launch Python programs
  • Taurus


  • Installed Python will be added to PATH as py command
  • Installed pip is not added to PATH, but you can run it with py -m pip install --upgrade bzt.

After installation is finished, you can run Taurus with bzt from command prompt.

Installing Taurus Manually

Install Taurus System Dependencies

  1. Get Python 2.7 from and install it, don't forget to enable "Add python.exe to Path" checkbox.
  2. Get latest Java from and install it.

Install Taurus Python Dependencies

Open Command Prompt with administrative privileges (find Command Prompt in main menu and chose Run as administrator from context menu). Then run the following command to update Python package manager to the latest version:

pip install --upgrade pip
Install lxml Package
pip install lxml

If this command fails, you can install lxml with Windows installer provided at project's PyPI page. Just download lxml-3.6.0.win32-py2.7.exe installer (or, if you've installed 64-bit Python) and run it.

Install psutil Package
pip install psutil

If this command fails, you can install psutil with Windows installer provided at project's PyPI page. Download psutil-4.2.0.win32-py2.7.exe file (or for 64-bit Python) and install it.

Install Taurus
pip install bzt

Upgrading Taurus

To upgrade Taurus, open Command Prompt as administrator and run

 pip install --upgrade bzt

Mac OS

You will need python 2.7 or higher and Java Runtime installed.

If you're on El Capitan, please execute first:

brew install python

Most likely you also need to upgrade setuptools:

sudo pip install --upgrade setuptools

Then install Taurus:

sudo pip install bzt

If you experience libxml/xmlversion.h missing error, try running:

brew install libxml2
brew install libxslt

then try installing Taurus again.

Upgrading to latest is as simple as this:

sudo pip install --upgrade bzt



Instructions are tested on Ubuntu 14.04 (Trusty) minimal install, but should work on other distributions with corresponding packages and libs. You will need python 2.7 or higher and Java installed.

sudo apt-get update
sudo apt-get install python default-jre-headless python-tk python-pip python-dev \
  libxml2-dev libxslt-dev zlib1g-dev
sudo pip install bzt

Upgrading to latest is as simple as this:

sudo pip install --upgrade bzt

Alternatively, you can install using virtualenv, and you will not need sudo privileges for Taurus. Please see virtualenv instructions for setting up your Python virtual environments, if you haven't done so already.

Then, to install Taurus, type:

pip install bzt

Upgrade is only:

pip install --upgrade bzt


Use uname -a to verify the system if it's 32 bit or 64 bit machine.

Get corresponding EPEL (Extra Package for Enterprise Linux) for CentOS (Community Enterprise OS) 7, and enable it.

sudo rpm -ivh epel-release-7-5.noarch.rpm

Optional Step: Verify EPEL repository

sudo yum repolist

For example, this has a line like this epel/x8664 Extra Packages for Enterprise Linux 7 - x8664

Install python-pip

sudo yum -y install python-pip

Install corresponding libraries for CentOS

sudo yum install java-1.7.0-openjdk-headless.x86_64 python-devel.x86_64 \
  libxml2-devel.x86_64 libxslt-devel.x86_64 zlib.x86_64 gcc.x86_64

You could search by 'yum search xxxxx' where 'xxxxx' represents the name of the library.

Install Taurus:

sudo pip install bzt

Docker Image

Taurus has Docker image that allows you to run tool as container.

To use it, create a directory, for example /tmp/my-test, put all YAML configs and additional files like JMXses there, then start Docker like this:

sudo docker run --rm -v /tmp/my-test:/bzt-configs undera/taurus

Make note that /tmp/my-test were passed in -v Docker option, it's crucial. Also note that you have to use .yml as config file extension. Here's what happens inside container:

  1. Directory /tmp/my-test is mounted as /bzt-configs
  2. Current directory changed to /bzt-configs
  3. Taurus is started with following command: `bzt /bzt-configs/*.yml`

Accessing Taurus Artifacts

If you want to receive Taurus artifacts from container, just mount some directory as /tmp/artifacts and files will get there. Following example gives you artifacts in /tmp/my-run-artifacts directory.

sudo docker run --rm -v /tmp:/bzt-configs -v /tmp/my-run-artifacts:/tmp/artifacts undera/taurus