Automate app installation and licensing for Atlassian applications

You can automate the setup of Atlassian applications—including Jira, Confluence, Bitbucket, and Bamboo—for testing or production using ACLI. This process simplifies the installation and licensing of required apps with a single command per application, saving time and reducing manual configuration.

At Appfire, we regularly use this method to create test instances quickly and consistently.

Recommended: 

Create a licenses directory containing all your app license files. Follow the steps outlined in How to install and license many apps to maintain and update this directory as needed.

These examples require ACLI version 8.3 or higher.

Set up Jira with app installation and licensing

To install and license standard apps for Jira, use the following command:

atlassian jira -a run --file install-jira-addons.txt

`install-jira-addons.txt` contents:

# Install standard add-ons with licenses for Jira

upm -a runFromList --continue \
     --common "-a installApp --wait --app @entry@" \
     --list " \
         org.swift.jira.cli, \
         org.swift.jira.acli, \
         org.swift.jira.cot, \
         org.swift.jira.cw, \
         org.swift.jira.clone-plus, \
         \
         is.origo.jira.tempo-plugin, \
         com.almworks.jira.structure, \
         \
         com.googlecode.jira-suite-utilities, \
     "

upm -a addLicenses --file licenses

Set up Confluence with app installation and licensing

To install and license standard apps for Confluence, run:

atlassian confluence -a run --file install-confluence-addons.txt

`install-confluence-addons.txt` contents:

# Install standard add-ons with licenses for Confluence

upm -a runFromList --continue \
     --common "-a installApp --wait --app @entry@" \
     --list " \
         org.swift.confluence.cli, \
         org.swift.confluence.acli, \
         org.swift.confluence.cache, \
         org.swift.confluence.excel, \
         org.swift.confluence.flash, \
         org.swift.confluence.html, \
         org.swift.confluence.macrosecurity, \
         org.swift.confluence.markdown, \
         org.swift.confluence.run, \
         org.swift.confluence.sql, \
         org.swift.confluence.script, \
         org.swift.confluence.table, \
         org.swift.confluence.visio, \
         org.swift.confluence.wiki, \
         com.appfire.confluence.codepro, \
         com.atlassian.confluence.extra.graphviz, \
         \
         com.adaptavist.confluence.contentFormattingMacros, \
         net.customware.confluence.plugin.linking, \
         net.customware.confluence.plugin.reporting, \
         net.customware.confluence.plugin.composition, \
         net.customware.confluence.plugin.visibility, \
         net.customware.confluence.plugin.scaffolding, \
         com.atlassian.confluence.plugins.editor.confluence-source-editor, \
     "

upm -a addLicenses --file licenses

Set up Bitbucket with app installation and licensing

To install and license standard apps for Bitbucket, run:

atlassian bitbucket -a run --file install-bitbucket-addons.txt

`install-bitbucket-addons.txt` contents:

# Install standard add-ons with licenses for Bitbucket

upm -a runFromList --continue \
     --common "-a installApp --wait --app @entry@" \
     --list " \
         org.swift.stash.cli, \
         org.swift.stash.acli, \
     "

upm -a addLicenses --file licenses

Set up Bamboo with app installation and licensing

To install and license standard apps for Bamboo, use:

atlassian bamboo -a run --file install-bamboo-addons.txt

`install-bamboo-addons.txt` contents:

# Install standard add-ons with licenses for Bamboo

upm -a runFromList --continue \
     --common "-a installApp --wait --app @entry@" \
     --list " \
         org.swift.bamboo.cli, \
         org.swift.bamboo.acli, \
         org.swift.bamboo.groovy, \
         com.appfire.bamboo.sql, \
         com.davidehringer.atlassian.bamboo.maven.maven-pom-parser-plugin, \
         org.gaptap.bamboo.maven.maven-artifact-download-plugin, \
     "

upm -a addLicenses --file licenses

Example: Bamboo installation output

Here’s an example output when running the Bamboo installation script:

atlassian bamboo -a run --file install-bamboo-addons.txt

Run: upm -a runFromList --common "-a installApp --wait --app @entry@" --list " org.swift.bamboo.cli, org.swift.bamboo.acli, org.swift.bamboo.groovy, com.appfire.bamboo.sql, com.davidehringer.atlassian.bamboo.maven.maven-pom-parser-plugin, org.gaptap.bamboo.maven.maven-artifact-download-plugin, "

Run: -a installApp --wait --app org.swift.bamboo.cli
App 'Bob Swift Atlassian Add-ons - Bamboo CLI Connector' installed with version 7.7.0

Run: -a installApp --wait --app org.swift.bamboo.acli
App 'Bob Swift Atlassian Add-ons - Run CLI Actions in Bamboo' installed with version 7.7.0

Run: -a installApp --wait --app org.swift.bamboo.groovy
App 'Bob Swift Atlassian Add-ons - Groovy Tasks' installed with version 2.8.0

Run: -a installApp --wait --app com.appfire.bamboo.sql
App 'Bob Swift Atlassian Add-ons - SQL Tasks' installed with version 1.2.0

Run: -a installApp --wait --app com.davidehringer.atlassian.bamboo.maven.maven-pom-parser-plugin
App 'Maven POM Value Extractor' installed with version 1.7.0

Run: -a installApp --wait --app org.gaptap.bamboo.maven.maven-artifact-download-plugin
App 'Maven Artifact Download Plugin' installed with version 1.1

Run completed successfully. 6 actions were successful.

Run: upm -a addLicenses --file licenses
License added to app org.swift.bamboo.acli.
License added to app com.appfire.bamboo.sql.
4 apps found that use licensing. 3 licenses added or matched existing license.

Run completed successfully. 2 actions were successful from file '.../install-bamboo-addons.txt'.