CLI Client Installation and Use

We recommend using the platform specific installers for an easier, automated installation process customized for Windows, MacOS, and Linux.

Other ways to use and install ACLI are linked below in the Other Downloads section.



Certain Atlassian products require a connector app

After installation, if your client reports a licensing error running some actions, ask your site administrator to install the ACLI connector app for Jira, Confluence, Bitbucket Server, or Bamboo in order to use the ACLI with those Atlassian products.

Installing on Windows, MacOS, and Linux

The MacOS desktop UI is shown in the illustrations below.

  1. Download and launch the installer for your OS (Windows, MacOS, or Linux).

  2. Click “Next” once you have read the welcome message from Bob Swift.

  3. Accept the End User License Agreement (EULA) and click “Next”.
    If you do not wish to accept the EULA select “I do not accept the agreement” and click “Next” or click Cancel”.

  4. Select where you wish to install the ACLI. This defaults to the folder “ACLI” underneath your user directory.

  5. If your installation directory already contains an ACLI installation, then you will be prompted to confirm whether to overwrite it or upgrade. If you choose to overwrite, you will be given the option for the installer to first make backups of user modifiable files

  6. When doing a new install or re-install, you can optionally enroll in a getting started email newsletter subscription. Clear the checkbox to decline enrollment.

  7. Installer now gives you some installation options including adding the installation directory to your path and whether or not have the installer automatically start the ACLI Shell. We recommend all users start and use the shell as it provides the best user experience and is especially helpful for new users. ACLI Shell will help you configure access to your applications and make it easier to discover and learn the ACLI.

  8. The installer is now to ready to install the ACLI and apply your configuration preferences. Click “Next”.

  9. The Installer will show progress of the installation process.

  10. Once concluded, an independent terminal window should open running the ACLI Shell (provided that configuration option was checked on initial installer options screen mentioned above). Also, the installer completion dialog will be shown - press “Finish” to complete the installation process. The ACLI Shell terminal will remain open. For new installs or re-installs, the ACLI Shell will open and start a configuration setup dialog to walk you through adding one or more site configurations. Upgrade installs will take you directly to the standard ACLI Shell interface initialized to your last used site.

  11. You can also launch the ACLI manually:

    1. From the Desktop shortcut or Start menu in Windows

    2. The Launchpad on MacOS.

    3. The console command: acli in Windows, MacOS, and Linux.

Previous versions


Log a request with our support team.

Confluence®, Jira®, Atlassian Bamboo®, Bitbucket®, Fisheye®, and Atlassian Crucible® are registered trademarks of Atlassian®
Copyright © 2005 - 2024 Appfire | All rights reserved. Appfire™, the 'Apps for makers™' slogan and Bob Swift Atlassian Apps™ are all trademarks of Appfire Technologies, LLC.