> For the complete documentation index, see [llms.txt](https://docs.qyrus.com/web-testing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qyrus.com/web-testing/integrations.md).

# Integrations

Connect Qyrus to the tools your team already uses — so you can raise a Jira ticket from a failed test, push results to TestRail, or get a Slack message when a run finishes.

### Configurations are created once and shared

A configuration — your Jira site, your TestRail account — is created **once, centrally**, and then pointed at the projects that should use it. You do not set the same thing up again in every project.

There are two ways to the same place:

* From anywhere, the **⋯** menu in the top bar → **Integration**.
* From inside a project, **Project Setup** → **Integrations** → **Add Configuration**, which opens the same central page. See [Project Setup](/web-testing/build/projectsetup.md).

![The Integrations page](https://239974709-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FycS61vFhJMvvtnJCrDJk%2Fuploads%2Fgit-blob-13de036f382157b182fcf5538e25c6ca36781764%2Fintegrations-hub-01.png?alt=media)

The first time you open it, a **Usage Reminder** asks you to confirm you will not enter sensitive, production or confidential information. Tick **I understand and agree.** and click **Continue**.

### What you can connect

Integrations are grouped by what they do. Use the **Categories** list on the left to narrow them.

| Category                   | Integrations                               |
| -------------------------- | ------------------------------------------ |
| **Project Management**     | Jira, Xray, Testrail, Monday, Rally, Azure |
| **Continuous Integration** | Jenkins, Github, Bitbucket                 |
| **Incident Management**    | Pagerduty                                  |
| **Notifications**          | Slack, Microsoft Teams                     |
| **BYOL Plugin**            | Browser Stack                              |

**Most Popular** at the top is a shortcut to Slack and Microsoft Teams.

### Adding a configuration

Click the **+** on the integration you want. Each one opens its own configuration form, but they follow the same shape:

1. Give the configuration a name.
2. Enter the connection details for the other tool.
3. Test the connection.
4. Choose which Qyrus projects may use it, under **Project selection** — pick the team, then the service, then tick the projects.
5. Click **Create Configuration**.

You can create more than one configuration for the same tool — a separate Jira configuration per Jira site, for instance.

### Guides

| Integration | Guide                                             |
| ----------- | ------------------------------------------------- |
| Jira        | [Jira](/web-testing/integrations/jira.md)         |
| TestRail    | [TestRail](/web-testing/integrations/testrail.md) |
| Xray        | [Xray](/web-testing/integrations/xray.md)         |

The others follow the same pattern: open the tile, fill in the connection details that tool needs, and choose your projects.
