Skip to content
Armada Docs

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

ScopePurpose
read:jira-workRead issues, projects, and user data
write:jira-workCreate issues, add links, post comments
storage:appStore 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”