---
title: Installation Guide
description: "[Mria CRM](https://marketplace.atlassian.com/apps/4108768729/mria-crm-crm-for-jira-teams?hosting=cloud&tab=overview) is exclusively available for **Jira Cloud** and is built on Atlassian Forge. As a Forge app, it runs on Atlassian’s secure cloud infrastructure, so you’ll see the **“Runs on Atlassian”** badge on the Marketplace listing. There are two…"
url: "https://mriacrm.com/docs/installation-guide/"
updated: "2026-11-18"
category: Get Started
---

# Installation Guide

[Mria CRM](https://marketplace.atlassian.com/apps/4108768729/mria-crm-crm-for-jira-teams?hosting=cloud&tab=overview) is exclusively available for **Jira Cloud** and is built on Atlassian Forge. As a Forge app, it runs on Atlassian’s secure cloud infrastructure, so you’ll see the **“Runs on Atlassian”** badge on the Marketplace listing.

There are two ways to install Mria CRM:

- From the [**Atlassian Marketplace website**](https://marketplace.atlassian.com/apps/4108768729/mria-crm-crm-for-jira-teams?hosting=cloud&tab=overview)
- From **Jira’s Manage apps** menu

## Install via Atlassian Marketplace (Web)

1. Open [Atlassian Marketplace](https://marketplace.atlassian.com/) and search for **Mria CRM**.

[![Installation Guide: Install via Atlassian Marketplace (Web)](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-01.png)](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-01.png)

1. Click on the **Mria CRM** listing to open the details page. Make sure it’s published by **Mria Labs** and has the *Runs on Atlassian* badge.
2. Click **Try it free**.

[![Installation Guide: Install via Atlassian Marketplace (Web)](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-02.png)](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-02.png)

1. Log in with your Atlassian account if prompted, then select your **Jira Cloud site** where the app should be installed. Click **Review**.
2. Confirm by clicking **Start free trial**. If you don’t have admin rights, you’ll see a **Request app** button that sends a request to your Jira admin.
3. Once installed, go to Jira → **Apps** → **Mria CRM** to launch the app.

> 💡 **Note:** You must be a **Jira Administrator** to install apps directly. Non-admins can only request the app.

## Install via Jira “Manage Apps” (In-Product)

1. In your Jira Cloud top navigation, click **Apps** → **Explore more apps**.
2. In the search bar, type **Mria CRM** and press Enter.
3. Select **Mria CRM** from the results to open details.
4. Click **Try it free**.

[![Installation Guide: Install via Jira Manage Apps (In-Product)](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-03.png)](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-03.png)

1. Select a site, review details and click **Start free trial**.

[![Installation Guide: Install via Jira Manage Apps (In-Product)](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-04.png)](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-04.png)

1. After installation, you’ll see a confirmation message. Access the app from **Apps** → **Mria CRM**.

✅ That’s it! Mria CRM is now installed on your Jira Cloud site. You can start configuring your CRM and managing Leads, Deals, Contacts, and Companies directly within Jira.

The first time each user opens Mria CRM, a two-minute product overview introduces the modules. It can be replayed at any time from [Settings → General](/docs/general-settings/).

## Sample Data on New Installations

When Mria CRM is installed on your Jira site for the first time, your workspace comes pre-populated with a small set of **sample records** across Leads, Deals, Contacts, Companies, and Products. Every sample record is tagged with the **[SAMPLE]** suffix so you can tell them apart at a glance.

Sample data is there so you can:

- See how each list, filter, Kanban board, and Report looks with real content — without spending time creating test entries.
- Get a feel for how entities link together: sample Deals reference sample Contacts, Companies, and Products so you can explore relationships end-to-end.
- Explore **Dashboards** — Sales Overview shows populated funnels and KPIs from the very first login.

[![Installation Guide: Sample Data on New Installations](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-05.png)](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-05.png)

[![Installation Guide: Sample Data on New Installations](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-06.png)](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-06.png)

While sample records remain, the Leads, Deals, Contacts, Companies and Products lists carry a banner saying so, with the order to delete them in:

[![Installation Guide: Sample Data on New Installations](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-07.png)](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-07.png)

Click **✕** to dismiss it. It then stays hidden for you on all five lists.

### Deleting sample data when you’re done trialing

When you’re ready to switch to your own data, delete the sample records in this order to avoid dependency notifications (for example, *“Contact is set as primary in a Deal”*):

1. **Deals** first
2. **Leads / Contacts / Companies** — in any order
3. **Products** last

Because Deals reference Contacts, Companies, and Products, removing Deals first clears those links cleanly before you touch the other entities.

**Reports & Dashboards:** deleting sample data also removes every trace of it from Reports and Dashboards. Once the cleanup is done, they reflect only your real data — no leftover sample rows or metrics.

## Updates and New Permissions

Mria CRM ships as a Forge [rolling release](https://developer.atlassian.com/platform/forge/rolling-releases-tutorial/). New versions install on your site automatically — there is no update button to press and nothing to schedule, so most releases simply appear.

The exception is a release that asks for **additional permissions**. Atlassian never grants those silently, so a Jira admin has to approve them. Until then:

- the features that need the new permissions stay **inactive**;
- every other feature and fix in the release works **normally** — a pending approval does not hold back the rest of the version.

### Approving new permissions

You need to be a Jira administrator, or an organization admin, to do this.

1. Open **Apps → Manage your apps** in Jira, then follow **Connected Apps** through to Atlassian Administration. (Direct route: **Administration → your site → Settings → Connected apps**.) Or open it directly: `https://admin.atlassian.com/s/<site-id>/user-connected-apps`, where `<site-id>` is the identifier shown after `/s/` in the address bar of any Atlassian Administration page for that site. It is different for every site, so keep one link per site if you administer several.
2. Find **Mria CRM** in the list and open **View app details**. When permissions are waiting, **App access** reads **Outdated** with an **Update** link next to it.
3. Click **Update**. The **Update to the latest version** dialog lists exactly what is being requested.
4. Review the list and click **Accept & Update**. **Cancel** leaves everything as it is — the version stays installed, the gated features stay off.
5. Afterwards, **App access** reads **Up to date**, and **View permissions** shows what the app currently holds.

[![Installation Guide: Approving new permissions](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-08.png)](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-08.png)

[![Installation Guide: Approving new permissions](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-09.png)](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-09.png)

[![Installation Guide: Approving new permissions](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-10.png)](https://mriacrm.com/wp-content/uploads/2026/11/installation-guide-10.png)

### What the Teamwork Graph permissions cover

Mria CRM requests seven permissions, grouped in the dialog under **Actions in Jira**. They exist for **Teamwork Graph support**, which publishes CRM records to the shared index behind Atlassian search and Rovo:

- Allows the user to view objects in the Team Work Graph
- Allows the user to create and update objects in the Team Work Graph
- Allows the user to delete objects in the Team Work Graph
- View user groups.
- View users.
- View system and custom avatars.
- View email addresses of all users regardless of the user’s profile visibility settings.

Approving these is what switches on Teamwork Graph support and the [Mria CRM custom fields in Jira](/docs/jira-integration/). Features that do not depend on them keep working while approval is pending.
[Release Notes](/docs/release-notes/)

Permissions are approved per site. If your organization runs Mria CRM on more than one Jira site, each one needs its own approval.

If you need to uninstall or manage the app later, go to **Jira Settings** → **Apps** → **Manage apps**.

For help, visit the [Mria CRM User Guide](/docs-category/using-mria-crm/) or contact [Mria Labs Support](https://mriacorp.atlassian.net/servicedesk/customer/portal/1).

 [https://www.addtoany.com/add_to/facebook?linkurl=https%3A%2F%2Fmriacrm.com%2Fdocs%2Finstallation-guide%2F&linkname=Installation%20Guide](https://www.addtoany.com/add_to/facebook?linkurl=https%3A%2F%2Fmriacrm.com%2Fdocs%2Finstallation-guide%2F&linkname=Installation%20Guide)[https://www.addtoany.com/add_to/x?linkurl=https%3A%2F%2Fmriacrm.com%2Fdocs%2Finstallation-guide%2F&linkname=Installation%20Guide](https://www.addtoany.com/add_to/x?linkurl=https%3A%2F%2Fmriacrm.com%2Fdocs%2Finstallation-guide%2F&linkname=Installation%20Guide)[https://www.addtoany.com/add_to/linkedin?linkurl=https%3A%2F%2Fmriacrm.com%2Fdocs%2Finstallation-guide%2F&linkname=Installation%20Guide](https://www.addtoany.com/add_to/linkedin?linkurl=https%3A%2F%2Fmriacrm.com%2Fdocs%2Finstallation-guide%2F&linkname=Installation%20Guide)
