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