Install Allure Testops via Docker Compose

The easiest way to run Allure Testops is to use a Docker Compose environment.

While not recommended for high-load use cases, this method is great for evaluating Allure Testops or even deploying it for a small project (up to 3 000 test cases per launch or 30 000 test cases per day).

Preparation steps

Install Docker and Docker Compose V2 plugin.

To check if Docker Compose V2 is installed, run this in a terminal:
```
docker compose version
```
Deploy external storage servers:
- two PostgreSQL databases (that could be single server, but two separate databases with different schema),
- one MinIO or other S3-compatible storage server,
- one RabbitMQ message server,
- one Redis storage server.
See Storage requirements for more details.

Installation without using external storage is also possible, as demonstrated in the testops-demo and testops-demo-ldap examples.

However, this option is intended for evaluation purposes only and is not officially supported. Maintaining and upgrading such a configuration can involve considerable downtimes or data loss.
Get a license for Allure Testops.

To receive the license key, fill out the form for a trial version or contact us at [email protected] for a commercial license.

When you receive the license key, you will also get a username and a password for accessing Qameta's Docker repository.
Get details for configuring authentication.

The required details depend on which approach to user authentication you choose. There are two possible approaches.
- Standard email-based authentication, implemented by Allure Testops itself.
  
  This requires a working SMTP account, e.g., a Gmail account. A new user will be able to register by entering their email address, to which Allure Testops will send a confirmation email.
- Authentication via an external identity provider.
  
  The details required for this may vary depending on what type of identity provider you use. Usually, you will need to specify an external URL and a secret token generated by the identity provider.
See Configuration → Authentication for more details.

Creating the configuration files

On this step, you will create a directory with two files:

docker-compose.yml — the definition of the cluster architecture. This file is provided by Qameta.
.env — the environment variables that will be used by Docker Compose when running the cluster. Qameta provides templates for this file which you need to customize for your needs.

To prepare the configuration files:

Visit one of the links below, depending on the type of authentication you want to use:
- testops for classic password-based authentication,
- testops-ldap for authentication via an LDAP server,
- testops-oidc for authentication via OpenID Connect (Keycloak, GitLab, Azure AD, Okta),

Download the docker-compose.yml and env-example files into an empty directory.
Rename the env-example file to .env (note the dot at the beginning!) and open it in a text editor.

The file defines parameters that will affect behavior of your Allure Testops instance. For the most typical setup, just do the following:

Choose TestOps release

In the ALLURE_VERSION parameter, specify the version of Allure Testops you want to use.

Check out the Release notes section for the list of available versions. In general, it is recommended to use the latest release.

Set TestOps URL

Specify the parameters that affect how the users will access Allure Testops: ALLURE_PROTO, ALLURE_HOST and ALLURE_INSTANCE_PORT.

In the example below, the parameters are set so that the Allure Testops instance would be available at “http://testops.example.com/” (using port 80, which is the default port for HTTP).

ALLURE_PROTO=http
ALLURE_HOST=testops.example.com
ALLURE_INSTANCE_PORT=80

To make Allure Testops available via HTTPS, you need to configure a reverse proxy. See Network configuration for more details.

Set admin credentials

To be able to log into Allure Testops for the first time, you need have an administrator account. Unlike all other accounts that are managed via the Members interface, the administrator account is managed via the configuration parameters directly.

In the ALLURE_ADMIN parameter, specify a login you want to use for the administrator account, e.g., “admin”.

In the ALLURE_ADMIN_PASS parameter, specify a password. Alternatively, you can leave this parameter empty, in which case a new password will be generated for the administrator account each time the allure-uaa service is restarted (see Managing services status). You will be able to find the generated password in the service logs.

See Configuration → Authentication for more details.

Configure authentication

A necessary step when deploying Allure Testops is to configure how users will be registered and logged in. See Configuration → Authentication for more details.

Below are some configuration examples for various identity providers.

# please remember, this is an example, which won't work for you, 
# you need to update your config with real SMTP server data.
ALLURE_MAIL_HOST=smtp.gmail.com
ALLURE_MAIL_PORT=465
ALLURE_MAIL_USERNAME=username
ALLURE_MAIL_PASSWORD=password
[email protected]
ALLURE_MAIL_SMTP_AUTH=true
ALLURE_MAIL_SMTP_STARTTLS_ENABLE=true
ALLURE_MAIL_SMTP_STARTTLS_REQUIRED=true
ALLURE_MAIL_SMTP_SSL_ENABLE=true
ALLURE_MAIL_SMTP_SSL_TRUST=smtp.gmail.com

LDAP_URL="ldaps://ldaps.space:636"
LDAP_USER_SEARCH_BASE="ou=People,dc=space"
LDAP_USER_SEARCH_FILTER="uid={0}"

LDAP_SYNC_ROLES=false
LDAP_GROUP_SEARCH_BASE="ou=group,dc=space"
LDAP_GROUP_SEARCH_FILTER="memberUid={1}"
LDAP_GROUP_ROLE_ATTRIBUTE=cn
LDAP_UID_ATTRIBUTE=uid

LDAP_MAPPING_ROLE_USERS=atousers,every_user_is_user
LDAP_MAPPING_ROLE_ADMINS=atoadmins,every_user_is_admin

# Default role, can be ROLE_GUEST/ROLE_USER/ROLE_ADMIN
LDAP_DEFAULT_ROLE=ROLE_GUEST

LDAP_LOGIN_SA="cn=admin,dc=space"
LDAP_LOGIN_SA_PASS=SeriviceAccountPassword_Here

this integration is not ready yet

Configure storage services

Specify the details for connecting to the storage services required for Allure Testops.

Connection to the Redis storage server
- ALLURE_REDIS_HOST — server hostname.
- ALLURE_REDIS_PORT — server port.
- ALLURE_REDIS_PASS — password for connecting to the storage.
Connection to the PostgreSQL database for authentication data
- ALLURE_UAA_DB_HOST — database server hostname.
- ALLURE_UAA_DB_PORT — database server port.
- ALLURE_UAA_DB_NAME — database name.
- ALLURE_UAA_DB_USERNAME — username for connecting to the database.
- ALLURE_UAA_DB_PASS — password for connecting to the database.
Connection to the PostgreSQL database for application data
- ALLURE_REPORT_DB_HOST — database server hostname.
- ALLURE_REPORT_DB_PORT — database server port.
- ALLURE_REPORT_DB_NAME — database name.
- ALLURE_REPORT_DB_USERNAME — username for connecting to the database.
- ALLURE_REPORT_DB_PASS — password for connecting to the database.
Connection to the RabbitMQ server
- ALLURE_RABBIT_HOST — server hostname.
- ALLURE_RABBIT_PORT — server port.
- ALLURE_RABBIT_USER — username for connecting to the message queue.
- ALLURE_RABBIT_PASS — password for connecting to the message queue.
Connection to the S3-compatible storage server
- ALLURE_S3_URL — server URL.
- ALLURE_S3_BUCKET — S3 bucket name.
- ALLURE_S3_REGION — S3 region name.
- ALLURE_S3_ACCESS_KEY — access key for connecting to the bucket.
- ALLURE_S3_SECRET_KEY — secret key for connecting to the bucket.

Downloading Docker images

Before starting Allure Testops, you need to download (or “pull”) the required Docker images. This will include the images of Allure Testops services themselves, as well as some third-party Docker images, such as PostgreSQL, Redis, etc.

Open a terminal application.
Navigate to the Allure Testops installation directory, for example:
```
cd ~/allure-testops
```
Connect Docker to the Qameta repository by running the command below.

Before executing the command, replace USERNAME and PASSWORD with the credentials provided to you by the Qameta sales team. These credentials will be used when pulling the images of Allure Testops services.
```
docker login --username USERNAME --password PASSWORD
```
Pull the images.
```
docker compose pull
```
This process may take a few minutes, depending on the speed of your internet connection.

Activate license

When you run your Allure Testops installation for the first time, you need to activate it by entering a license key.

Open a terminal application.
Navigate to the Allure Testops installation directory, for example:
```
cd ~/allure-testops
```
Start the services by running the command:
```
docker compose up -d
```
Starting all the services of Allure Testops takes some time. Wait for a couple of minutes before proceeding to the next step.
In a web browser, go to the URL that you configured on the Set TestOps URL step. An authentication form should appear.

If you get an “Unable to connect” or “This site can't be reached” error in the browser, it may indicate that some services are still initializing. Normally, the initialization takes no more than a couple of minutes.

If the web browser still cannot open the page after five minutes, see the Troubleshooting section.
In the authentication form, enter the login and password that you configured on the Set admin credentials step.

Click Continue.
In the activation form, enter the license key that you got from Qameta sales team. Make sure to paste the key without any extra spaces or other characters.

Click Activate license.

Managing services status

Start services

To launch Allure Testops:

Open a terminal application.
Navigate to the Allure Testops installation directory, for example:
```
cd ~/allure-testops
```
Start the Docker containers.
```
docker compose up -d
```

Stop services

To stop Allure Testops:

Open a terminal application.
Navigate to the Allure Testops installation directory, for example:
```
cd ~/allure-testops
```
Run the command:
```
docker compose down
```

Restart services

To restart Allure Testops:

Open a terminal application.
Navigate to the Allure Testops installation directory, for example:
```
cd ~/allure-testops
```

Run the command:

docker compose down; docker compose up -d