> For the complete documentation index, see [llms.txt](https://docs.ativo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ativo.io/getting-started/quickstart-guide.md).

# Quickstart guide

{% embed url="<https://www.youtube.com/watch?v=l6YHBF8hJI4>" %}

### Step 1 – Installation

As a Jira admin, you can install the Ativo Programs app directly in Jira. Click on **Settings > Apps > Find new apps**.

Search for **Ativo**, click on the box, and then click on **Try it free**.

<figure><img src="/files/XNHAqLgad61b2mL7IGXo" alt=""><figcaption></figcaption></figure>

### Step 2 – Permissions

We wil now set the permissions. As a Jira admin click on **Jira admin > Apps > Ativo Programs > Administrators**.

Add the persons or groups you want to give Ativo Programs configuration permissions and click on **Save**.

<figure><img src="/files/KAiD4Qa3BDNS45sxuRcV" alt=""><figcaption></figcaption></figure>

### Step 3 – Teams

Now that we have permissions, we can configure the teams.

Locate Ativo Programs via **Apps > Programs** in the top navigation bar. Click on the **Create Teams** button.

We’ll add a first team. Fill in the **name**, choose a **key** (capital letters). Define if the team is working scrum (sprints) or Kanban. Choose the estimation model they are using.

Define the **filter**, which defines the scope of the issues of the team. Choose one or more **Jira projects**. If needed, we can narrow down the scope with one or more **field filters**.

We’ll now add a second team.

Then click on **Submit**.

<figure><img src="/files/KV1yAynucgrdusaqfPSi" alt=""><figcaption></figcaption></figure>

### Step 4 – ART (program) configuration

Now that we have teams, we can configure the ART (program).

Click on the **Create ART** button in the top navigation selection. Choose an ART **name** and **key** and click on **Create**.

Select the teams you want to add in the ART.

Select the filter for the epics (feature) backlog. This defines the scope of the ART.

For the optional issues filter, you can probably just leave it empty at this moment.

Click **Submit**.

<figure><img src="/files/LmXCaX0hpuOe6srOyTkG" alt=""><figcaption></figcaption></figure>

### Step 5 – PI

Now that we have defined the ART (program), we can configure the PI.

Click on **Create PI**, fill in the **name** and **key**, and define how many sprints you want to add to the period. Click on **Create**.

Set the **start dates** and **end dates** of the sprints.

For the teams working scrum, we’ll define the sprints. If the sprint names have a logical order with number in it, then Ativo will do a suggestion for the next sprints automatically.

If you need to create sprints in teams, you can do so in Ativo directly.

You can leave the optional additional epic and issue filters to the default setting (empty).

Click on **Submit**.

<figure><img src="/files/A16Lbt1La9KnCgQZKXV3" alt=""><figcaption></figcaption></figure>

### Conclusion

We’ve configured and installed Ativo Programs in 5 steps:

* Installation
* Permissions
* Teams configuration
* ART (program) configuration
* PI (period) configuration