---
title: Install Allure Report for Linux
description: How to install Allure Report 2 on Linux using Homebrew, a DEB package, or a manual archive download.
---

# Install Allure Report for Linux

To get the reporting process working you need to install two components:

- [Allure Report CLI tool](#install-the-allure-report-cli)
- [Allure integration for your test framework](#install-the-test-framework-integration)

## Install the Allure Report CLI

Allure Report can be installed on Linux from a Homebrew or DEB package or manually from an archive.

### Install from Homebrew

[![Allure Report commandline Homebrew latest version](https://img.shields.io/homebrew/v/allure?style=flat "Allure Report commandline Homebrew latest version")](https://formulae.brew.sh/formula/allure)

1. Make sure [Homebrew](https://brew.sh/) is installed.

1. In a terminal, run this command:

   ```
   brew install allure
   ```

1. Run this command to see if it reports the latest version:

   ```
   allure --version
   ```

### Install from a DEB package

[![Allure Report commandline latest version](https://img.shields.io/github/v/release/allure-framework/allure2?style=flat "Allure Report commandline latest version")](https://github.com/allure-framework/allure2/releases/latest)

1. Make sure that your Linux distribution supports installing software from DEB packages.

1. Go to [the latest Allure Report release on GitHub](https://github.com/allure-framework/allure2/releases/latest) and download the `allure-*.deb` file.

1. In a terminal, go to the directory with the file and install it. For example:

   ```
   sudo dpkg -i allure_2.29.0-1_all.deb
   ```

1. Run this command to see if it reports the latest version:

   ```
   allure --version
   ```

### Install from an archive

[![Allure Report commandline latest version](https://img.shields.io/github/v/release/allure-framework/allure2?style=flat "Allure Report commandline latest version")](https://github.com/allure-framework/allure2/releases/latest)

1. Make sure Java version 8 or above installed, and its directory is specified in the `JAVA_HOME` environment variable.

1. Go to [the latest Allure Report release on GitHub](https://github.com/allure-framework/allure2/releases/latest) and download the `allure-*.zip` or `allure-*.tgz` archive.

1. Uncompress the archive into an installation directory of your choice. For example:

   ```
   tar xf /home/user/Downloads/allure-2.29.0.tgz -C /home/user/tools
   ```

1. Make sure Allure is in your `PATH`, so you can invoke it from the command line by just typing `allure`.

   There are various ways to do so, for example, via the `update-alternatives` utility or by modifying the `PATH` variable.

   **Using update-alternatives**

   Details:

   1. Run the following two commands to register the new path to Allure Report and make it default.

      (Replace `/home/user/tools/allure-2.29.0/bin/allure` with the path to the `allure` binary file in your installation directory.)

      ```
      sudo update-alternatives --install /ust/bin/allure allure /home/user/tools/allure-2.29.0/bin/allure 10
      sudo update-alternatives --set allure /home/user/tools/allure-2.29.0/bin/allure
      ```

   2. If you have installed an older version before and do not need it anymore, unregister it, for example:

      ```
      sudo update-alternatives --remove allure /home/user/tools/allure-2.28.0/bin/allure
      ```

   **Modifying PATH**

   Details:

   1. Open the script that your command shell loads when logging in (it can be located at `~/.profile`, `~/.bash_profile`, `~/.zprofile`, etc.) and add the following line to the end of it.

   (Replace `/home/user/tools/allure-2.29.0/bin` with the path to the `bin` subdirectory file in your installation directory.)

   ```bash
   export PATH=$PATH:/home/user/tools/allure-2.29.0/bin
   ```

   2. If you have previously added a path to another version of Allure Report to `PATH`, make sure to remove it.

   3. Close the current terminal window, then open a new one.

1. Run this command to see if it reports the latest version:

   ```
   allure --version
   ```

## Install the test framework integration

Look for the integration for your test framework in the list of [Allure integrations](/docs/frameworks/), and follow the setup instructions.