Skip to content
Armada Docs

Quick Start

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

This guide walks you through launching your first campaign with Armada.

Before You Begin

Make sure you have:

  • Armada installed (Installation guide)
  • At least one project where you can create issues
  • Permission to create issues in target projects

Step 1: Configure Your Fleet

  1. Open any Jira issue and find the Armada panel in the sidebar
  2. Click Manage Fleet
  3. Add your first team:
    • Team Name: e.g., “Platform Team”
    • Project Key: e.g., “PLAT”
  4. Click Save

Step 2: Create a Parent Issue

Create the issue that will serve as your campaign’s “source of truth”:

Use an Epic when you want child issues to be subtasks in the hierarchy. 
- Type: Epic
- Summary: "Q4 Security Patch Rollout"
- Description: Details about what teams need to do
 Use a Story when you want linked issues rather than hierarchy. 
- Type: Story
- Summary: "Migrate to K8s - All Teams"
- Description: Migration instructions and deadlines

Step 3: Launch the Campaign

  1. Open your parent issue
  2. In the Armada panel, click Launch Campaign
  3. Select the teams you want to target
  4. Review the summary and click Launch

Armada will:

  • Create issues in each target project
  • Link them to your parent issue
  • Start tracking status automatically

Step 4: Monitor Progress

The Armada panel shows:

  • Progress bar: Overall completion percentage
  • Status breakdown: Issues by status category (To Do, In Progress, Done)
  • Team list: Status of each child issue

Click Refresh to get the latest status from Jira.

Step 5: Nudge Stale Issues

When issues go stale, you can send reminders:

  1. Click Nudge in the Armada panel
  2. Select issues that are overdue
  3. Click Send Nudges

Armada adds a comment to each selected issue reminding the team to provide an update.

What’s Next?