---
title: "Installation"
canonical: "https://docs.getxray.app/space/XRAYCLOUD/44566344/Installation"
format: markdown
---
<details>
<summary>Table of Contents</summary>

> Macro (toc)
</details>

# Introduction

There are two separate Xray apps:

- **[Xray Test Management for Jira](https://www.getxray.app/test-management?utm_source=adwords&utm_medium=cpc&utm_campaign=gg_search_bofu_xray_brand_europe&utm_term=xray%20test%20management&hsa_acc=9970092548&hsa_cam=21151579322&hsa_grp=179131227587&hsa_ad=742407804447&hsa_net=adwords&hsa_src=g&hsa_mt=e&hsa_kw=xray%20test%20management&hsa_tgt=kwd-488738308063&hsa_ver=3&gad_source=1&gad_campaignid=21151579322&gbraid=0AAAAACfrmty9ifZJ63zdRhjHC_tZnaHSM&gclid=CjwKCAjwkvbEBhApEiwAKUz6-5KVPUyEmAuIEJQMsiGYxe8xcN5GC1hHLA9kXxSF6S9V_zAIxpvU9BoCbBAQAvD_BwE)**: the core Test management solution for smaller teams.
- **[Xray Enterprise](https://www.getxray.app/xray-enterprise)**: a separate app for large-scale enterprises with cutting-edge testing features.

> ℹ️ Users who have been utilizing gadgets with both applications installed (Xray + Xray Enterprise) prior to release 6.9.0 will need to remove, reinstall, and reconfigure their gadgets, as they will become unavailable after uninstalling one of the apps. The same applies to users who move from Enterprise to Standard/Advanced or vice versa. In these cases, the existing [gadget](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44566250) configurations will no longer be valid and must be set up again to ensure proper functionality.
> ℹ️ 
> ℹ️ Go here to learn more about [Xray apps and tiers](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/392921546).

> ✅ These two apps are also available for [Atlassian Government Cloud (AGC)](https://developer.atlassian.com/platform/framework/agc/). See more below.

# Apps Installation

## [Xray Test Management for Jira](https://marketplace.atlassian.com/apps/1211769/xray-test-management-for-jira)

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> On your Jira Cloud instance, click the *Apps* button on Jira’s left bar (Figure 1 - 1) and select *Explore more apps *(Figure 1 - 2).
> 
> ![Figure 1 - Apps](media://f7b9e457-756f-493e-9ec6-c51668167a55)
> 
> 
> > Macro (rw-step)
> 
> A screen will open (Figure 1) for you to search for apps from the [Atlassian Marketplace](https://marketplace.atlassian.com/). Use the search bar (Figure 1 - 3) to look for Xray, and the result will appear (Figure 1 - 4). Click it.
> 
> 
> > Macro (rw-step)
> 
> The Xray screen will open. There, click on the *Try it free* button (Figure 2 - 1).
> 
> ![Figure 2 - Install](media://4217413a-cda3-4abc-9ecc-af567edb513b)
> 
> 
> > Macro (rw-step)
> 
> In the next page, select the site where you want to install Xray (in case your account is associated with multiple instances) (Figure 3 - 1). Then click on *Review *(Figure 3 - 2).
> 
> ![Figure 3 - Install - Select site](media://eff276e0-e120-436e-9528-9d1ba00b2a35)
> 
> 
> > Macro (rw-step)
> 
> Click the *Start free trial* button (Figure 4 - 1).
> 
> ![Figure 4.jpg](media://e7b2759b-301d-4ea0-9779-21f9cab946e1)
> 
> 
> > Macro (rw-step)
> 
> Wait for a few seconds while Xray is added to your Jira Cloud instance (Figure 5 - 1).
> 
> ![Figure 5.jpg](media://84f116af-785d-4b1b-9d4e-72c90fb7553c)
> 
> 
> > Macro (rw-step)
> 
> Then you will see a success message (Figure 6 - 1): the installation is concluded, and Xray is now added to your Jira Cloud instance.
> 
> ![Figure 6.jpg](media://aca96543-6881-46c9-abb2-3779f21328ba)

## [Xray Enterprise](https://marketplace.atlassian.com/apps/1229688/xray-enterprise)

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> On your Jira Cloud instance, click the *Apps* button on Jira’s left side menu (Figure 1 - 1) and select *Explore more apps *(Figure 1 - 1).
> 
> ![Figure 1 - Apps](media://ef50ec80-b76f-4ea6-8c7e-24d77345a6d5)
> 
> > Macro (rw-step)
> 
> The Marketplace screen will open (Figure 1). On the search bar (Figure 1 - 2), type “xray enterprise” and press Enter. Click the Xray Enterprise square (Figure 1 - 3).
> 
> > Macro (rw-step)
> 
> The Xray Enterprise app screen will open (Figure 2). Click *Try it free* (Figure 2 - 1).
> 
> ![Figure 2 - Xray Enterprise](media://8e064252-b811-4f12-b98d-801e1d50cefd)
> 
> > Macro (rw-step)
> 
> The Xray Enterprise app installation setup screen will open (Figure 3).
> 
> Select the instance where you want to have the Xray Enterprise app installed (Figure 3 - 1) and then click *Review* to proceed (Figure 3 - 2).
> 
> ![Figure 3 - Installation.png](media://327cb65d-40b0-42d0-8ffb-a541e997367b)
> 
> > Macro (rw-step)
> 
> The Review and install screen will open (Figure 4). Here, confirm the Permissions (Figure 4 - 1) and Data management (Figure 4 - 2) information.
> 
> Click *Start free trial* (Figure 4 - 3) to confirm and proceed with the Xray Enterprise app installation.
> 
> ![Figure 4 - Review.png](media://5d24b354-6b0c-49af-9b74-d0a6c245caea)
> 
> > Macro (rw-step)
> 
> Wait for a few seconds while the Xray Enterprise app is added to your Jira Cloud instance (Figure 5 - 1).
> 
> ![Figure 5 - Added](media://4fb3bf6e-f5df-4ba7-9d2a-4ecae16f64e2)
> 
> > Macro (rw-step)
> 
> Then you will see a success message (Figure 6 - 1): the installation is concluded, and the Xray Enterprise app is now added to your Jira Cloud instance.
> 
> ![Figure 6 - Success](media://4bb4c621-6252-4b12-a7b7-025f42219026)

## Xray for AGC

Xray has successfully met all technical, security, and operational requirements to be approved and listed as **compatible with **<u>**[Atlassian Government Cloud (AGC)](https://developer.atlassian.com/platform/framework/agc/)**</u> on the [Atlassian Government Cloud marketplace](https://marketplace.atlassian.com/collections/atlassian-government-cloud).

This approval confirms [Xray’s compliance with Atlassian’s](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/533823499) standards for platform stability, security, and operational reliability. 

To install Xray for AGC, follow these steps:

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> Access the [Atlassian Government Cloud marketplace](https://marketplace.atlassian.com/collections/atlassian-government-cloud) and search for Xray.
> 
> > Macro (rw-step)
> 
> Select the *Atlassian Government Cloud* option (Figure 7 - 1).
> 
> ![Figure 7 - Xray](media://670eceba-e376-4aca-b28e-95a9d0270813)
> 
> > Macro (rw-step)
> 
> Click the *Contact us* button (Figure 7 - 2). You will be redirected to [this page](https://www.atlassian.com/government/contact).
> 
> After you make the purchase, you will receive a bill for the Marketplace app with the number of users with access to your Atlassian Government app. Go [here](https://support.atlassian.com/organization-administration/docs/manage-apps-for-atlassian-government-products/) to know more.


<details>
<summary>Support/Troubleshooting</summary>

If you have questions or technical issues, please [contact the Support team via the Customer Portal (Jira service management)](https://jira.getxray.app/servicedesk/customer/portal/2/user/login?destination=portal%2F2%2Fcreate%2F28) or [send us a message using the in-app chat](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44577312).
</details>