If you are upgrading from 8.x, note that there were some significant changes in 9.0 that will impact your configuration and usage.

See Special Compatibility Notice for CLI Version 9.x.

The Atlassian Command Line Interface (CLI) supports a large range of product releases. The matrix below provides compatibility guidelines based on testing, API compatibility information provided by Atlassian, and community feedback. User's are encourage to help improve compatibility information through discussions and issues. The CLI also works with releases not officially listed here since in many cases it uses remote APIs provided by Atlassian that have been stable for many years. Check previous versions of the CLI for coverage of earlier releases. Users should verify their usage scenarios on new releases. Support normally is limited to minimum releases indicated. Client requires at least Java 8 (1.8) and we test with both Java 8 and 11. In some cases, new actions are only available on later versions of the server - these are often noted in the documentation or in error messages.

To simplify the matrix, we no longer list much older releases even though there is some level of compatibility for these as well. Refer to earlier compatibility notes for information on older releases.

See also Compatibility for overall information on supported Atlassian releases.

CLI Clients and Connectors

• 9.7 clients require connectors at version 9.4 or higher. 
• Cloud users usually need to update their clients regularly to address incompatibilities introduced by Atlassian with their daily Cloud updates. We deliver EAP releases to immediately cover any problems.
  • Atlassian Cloud Platform Changes Impacting CLI Users

Script Compatibility Warnings for 9.3 and higher

• JSON output changes - ACLI-1438 and ACLI-1453
• getIssue action - new project name field added to all output formats - see ACLI-1215
• findReplace parameter - no longer supports comma separated values - see ACLI-917

Run CLI Apps

Apps install and run on an Atlassian application server.

Atlassian App Compatibility

The Atlassian CLI supports a number of different Atlassian apps like Jira Software, Service Desk, and Confluence Questions. We only test and support the most current maintenance release of the apps available for the respective Atlassian application.

Atlassian Incompatibilities

The CLI clients always try to maintain upward compatibility between releases. However, in some cases this is not possible. Occasionally server differences may cause some compatibility issues.