# 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="https://2916206105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBAGNud2YIYXdGXre7dQK%2Fuploads%2FSFIhliPrOPAzNT6rgtGZ%2Finstallation2.png?alt=media&#x26;token=fdb5a6f6-f718-4cf0-8012-d5b0d7d399ce" 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="https://2916206105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBAGNud2YIYXdGXre7dQK%2Fuploads%2Fm3ION16SwSPDMMpIOemC%2FPermissions.png?alt=media&#x26;token=2f3a47eb-8382-428e-a7b6-72f9181307ff" 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="https://2916206105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBAGNud2YIYXdGXre7dQK%2Fuploads%2FtxEFlptE7zypk9xMNBpQ%2FTeams%20submit.png?alt=media&#x26;token=9e02c8a9-31c8-42ff-b4ab-9da5ed53f591" alt=""><figcaption></figcaption></figure>

### Step 4 – Program (Release train) configuration

Now that we have teams, we can configure the program (or release train).

Click on the **Create Program** button on the Ativo home screen. Choose a **program name** and **key** and click on **Submit**.

Select the teams you want to add in the program.

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

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

Click **Submit**.

<figure><img src="https://2916206105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBAGNud2YIYXdGXre7dQK%2Fuploads%2FJNtTlKEuQUCTfLu1b4pM%2FProgram%20creation.png?alt=media&#x26;token=a7857080-bb8b-4627-8399-b60d6e6501e3" alt=""><figcaption></figcaption></figure>

### Step 5 – Period (Program Increment)

Now that we have defined the program, we can configure the program increment.

Click on **Create period**, 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 another tab. Click the **Refresh sprints** button to import the latest sprints.

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

Click on **Submit**.

<figure><img src="https://2916206105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBAGNud2YIYXdGXre7dQK%2Fuploads%2FSmYjBD9xkmgxlY1rSOqO%2FSprints%20mapping.png?alt=media&#x26;token=4ddb8448-d5fe-4ce8-bd61-dee6b226d799" alt=""><figcaption></figcaption></figure>

### Conclusion

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

* Installation
* Permissions
* Teams configuration
* Program (Release train) configuration
* Period (Program Increment) configuration