Installation

import { Steps } from ‘@astrojs/starlight/components’;

Armada is available on the Atlassian Marketplace for Jira Cloud.

Prerequisites

• Jira Cloud (Standard, Premium, or Enterprise)
• Site administrator access to install apps
• Projects where you want to launch campaigns

Installation Steps

1. Visit the Marketplace

   Go to the Armada Marketplace listing and click “Get it now”.

2. Select your site

   Choose the Jira Cloud site where you want to install Armada.

3. Grant permissions

   Review and approve the required permissions:

   • read:jira-work - Read issue data
   • write:jira-work - Create and update issues
   • storage:app - Store configuration

4. Verify installation

   Open any Jira issue. You should see the “Armada” panel in the issue sidebar.

Post-Installation Setup

After installation, you’ll need to:

1. Configure your Fleet - Add teams and their projects
2. Set up Governance (optional) - Configure approval thresholds
3. Enable Auto-Nudge (optional) - Set up automated reminders

See the Quick Start guide for your first campaign.

Permissions Required

Scope	Purpose
read:jira-work	Read issues, projects, and user data
write:jira-work	Create issues, add links, post comments
storage:app	Store fleet config and campaign state

Troubleshooting

”Armada panel not showing”

1. Refresh the page
2. Check if the app is installed in your site’s “Manage apps” settings
3. Verify you have access to the project

”Permission denied”

Armada inherits your Jira permissions. If you can’t create issues in a project, Armada can’t either. Contact your Jira administrator.

Uninstallation

To remove Armada:

1. Go to Jira Settings > Apps > Manage apps
2. Find “Armada” and click “Uninstall”

Caution

Uninstalling removes all Armada configuration data. Campaign state stored on issues is preserved.