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

# Install Allure Report for macOS

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 the Homebrew package repository 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 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. 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
   ```

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

1. Close and re-open the terminal window.

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.