---
title: Install tempest on Linux | Snap Store
description: Get the latest version of tempest for Linux - OpenStack Integration Test
  Suite
url: https://snapcraft.io/tempest
---

# tempest

[Canonical](https://snapcraft.io/publisher/canonical "View all snaps from Canonical")

* [Canonical](https://snapcraft.io/publisher/canonical "View all snaps from Canonical")
* [Server and Cloud](https://snapcraft.io/search?categories=server-and-cloud)

2026.1/stable 47.0.0

Install 2026.1/stable of tempest

---

**Install using the command line**

```
sudo snap install tempest
```

Don't have snapd? [Get set up for snaps](https://snapcraft.io/docs/installing-snapd).

---

### Package name

* tempest

---

### License

* Apache-2.0

---

### Last updated

* 29 September 2026 - 2026.1/stable
* 28 September 2026 - latest/candidate

---

### Websites

* [github.com/canonical/snap-tempest](https://github.com/canonical/snap-tempest "https://github.com/canonical/snap-tempest")

---

### Command › Alias

* tempest.discover › discover-tempest-config

---

##### Report a Snap Store violation

* [Report this Snap](https://snapcraft.io/tempest#report-snap-modal)

---

* [Description](https://snapcraft.io/tempest#tab-description)
* [Security](https://snapcraft.io/tempest#tab-security)

#### OpenStack Integration Test Suite

Tempest is a set of integration tests to be run against a live
OpenStack cluster. Tempest has batteries of tests for OpenStack
API validation, Scenarios, and other specific tests useful in
validating an OpenStack deployment.

Alongside with the tempest project, this snap also includes the currently maintained tempest plugins,
the python-tempestconf package and several curated test lists to provide ease of use.

The python-tempestconf package provides `discover-tempest-config` command line
application that automatically generates a tempest configuration appropriate for your cloud.

**Note**: Tempest workspace initialized by different versions of the snap cannot be shared. If you refresh or revert tempest snap, you must re-initialized the workspace using the refreshed or reverted snap, or manually update the `test_path` and `top_dir` in `.stestr.conf` to the correct path.

**Plugins**

---

The snap provides all the plugins listed in the OpenStack release notes and those
cannot be removed or updated. Currently, it is not possible to add new plugins or use
your own.

List of plugins:

* barbican-tempest-plugin
* blazar-tempest-plugin
* cinder-tempest-plugin
* cloudkitty-tempest-plugin
* cyborg-tempest-plugin
* designate-tempest-plugin
* ec2api-tempest-plugin
* freezer-tempest-plugin
* glance-tempest-plugin
* heat-tempest-plugin
* ironic-tempest-plugin
* keystone-tempest-plugin
* kuryr-tempest-plugin
* magnum-tempest-plugin
* manila-tempest-plugin
* mistral-tempest-tests
* monasca-tempest-plugin
* murano-tempest-plugin
* neutron-tempest-plugin
* octavia-tempest-plugin
* oswin-tempest-plugin
* sahara-tests
* senlin-tempest-plugin
* solum-tempest-plugin
* telemetry-tempest-plugin
* trove-tempest-plugin
* venus-tempest-plugin
* vitrage-tempest-plugin
* watcher-tempest-plugin
* zaqar-tempest-plugin
* zun-tempest-plugin

**Quickstart**

---

Running the tempest smoke suite against a deployed OpenStack cloud would look like this.

```
# Install the tempest snap
sudo snap install tempest

# Have the cloud credentials in the environment
source novarc

# Initialize a tempest workspace directory called cloud-01
tempest init cloud-01
cd cloud-01

# Generate the tempest configuration specific to the cloud
# use `--create` flag if resources like flavors needs to be created
discover-tempest-config

# Run the tempest smoke suite
tempest run --smoke
```

For more information please refer to the Tempest QuickStart and python-tempestconf documentation.

**Test Lists**

---

The tempest snap provides a set of pre-defined test lists with different profiles
and a mechanism to specify them easily.

The `@BUILTIN_TESTLISTS` keyword will be automatically replaced by the full path
of the directory storing the built-in test lists.

**Note**: the single-quotation marks around the test list file path is required
if the `@BUILTIN_TESTLISTS` keyword is used (in other words, when running tempest
with a built-in test list file). Failure to do so will result in a wrong path
error.

**readonly-quick**
For quickly verifying the behavior of the target cloud and making sure tempest
is correctly set up

```
 tempest run --load-list '@BUILTIN_TESTLISTS/readonly-quick'
```

**refstack-2022.11**
Version 2022.11 of the RefStack guidelines.
The list includes the required and advisory tests of all platforms.

```
 tempest run --load-list '@BUILTIN_TESTLISTS/refstack-2022.11'
```

**Links**

---

OpenStack Release Notes
<https://releases.openstack.org/antelope/index.html#tempest-plugins>

python-tempestconf
<https://opendev.org/openinfra/python-tempestconf>

`discover-tempest-config`
<https://docs.opendev.org/openinfra/python-tempestconf/latest/cli/cli_options.html#discover-tempest-config>

Tempest QuickStart
<https://docs.openstack.org/tempest/latest/overview.html#quickstart>

RefStack
<https://refstack.openstack.org/#/>

---

## Install tempest on your Linux distribution

Choose your Linux distribution to get detailed installation instructions. If yours is not shown, get more details on the [installing snapd documentation](https://snapcraft.io/docs/installing-snapd).

[### Arch Linux](https://snapcraft.io/install/tempest/arch)

[### CentOS](https://snapcraft.io/install/tempest/centos)

[### Debian](https://snapcraft.io/install/tempest/debian)

[### elementary OS](https://snapcraft.io/install/tempest/elementary)

[### Fedora](https://snapcraft.io/install/tempest/fedora)

[### KDE Neon](https://snapcraft.io/install/tempest/kde-neon)

[### Kubuntu](https://snapcraft.io/install/tempest/kubuntu)

[### Manjaro](https://snapcraft.io/install/tempest/manjaro)

[### Pop!\_OS](https://snapcraft.io/install/tempest/pop)

[### openSUSE](https://snapcraft.io/install/tempest/opensuse)

[### Red Hat Enterprise Linux](https://snapcraft.io/install/tempest/rhel)

[### Ubuntu](https://snapcraft.io/install/tempest/ubuntu)

[### Raspberry Pi](https://snapcraft.io/install/tempest/raspbian)
