JIRA Agile Installation and Upgrade Guide
The information on this page only applies if you are using JIRA Agile with JIRA Server. If you are using JIRA Agile with JIRA Cloud, you do not need to install JIRA Agile as it is bundled as a commercial add-on. For more details, read Atlassian OnDemand and Add-ons (Plugins).
Before you begin
We highly recommend that you upgrade/install JIRA Agile outside of office hours, as the installation/upgrade tasks may reduce the performance of your server. Please also check the following before you start the installation/upgrade:
- Check your JIRA permissions. The JIRA System Administrators global permission is required for the instructions on this page.
- Check the Supported Platforms for JIRA Agile:
- Ensure your version of JIRA supports the intended JIRA Agile version.
If you are using a version of JIRA prior to 6.0, please use these instructions instead of the page you are currently reading. - Ensure that your browser is supported.
- Ensure your version of JIRA supports the intended JIRA Agile version.
- Check for any known issues in the JIRA Agile Knowledge Base.
- Allocate an extra 256M of RAM to JIRA, just for JIRA Agile — i.e. please allocate a minimum of 512M to JIRA, instead of 256M. For details on how to do this, please see: Increasing JIRA Memory.
Please note: JIRA Agile alters JIRA database tables to support project templates. Also, JIRA Agile will add additional tables to the JIRA database. However, enabling or disabling the JIRA Agile add-on will not cause any damage to your JIRA data.
Installing JIRA Agile
Step 1. Install the JIRA Agile Add-on
If you are using JIRA 6.3.1 or later, you will have the option of including JIRA Agile when you install JIRA, as JIRA Agile is bundled with JIRA. If you have done this, you do not need to install it again. However, you may need need to upgrade it (after entering your license details), as the bundled JIRA Agile version may not be compatible with the JIRA.
- Log in to JIRA as a user with the 'JIRA System Administrators' global permission.
- Click the 'cog' icon on the top bar (or click Administration if using an older version of JIRA) and select Add-ons. The Universal Plugin Manager (UPM) page will be displayed.
- On the Find new add-ons page, type 'JIRA Agile' in the search box.
- The JIRA Agile add-on will appear in the list below the search box. Click the Install button. A confirmation message and the add-on details will display, if it is installed successfully.
If your JIRA instance is on a server that cannot access the internet, you will need to download the JIRA Agile add-on separately (from the Atlassian Marketplace) and install the add-on file by upload, as described here: Installing Marketplace apps.
Step 2. Enter your JIRA Agile License
- Log in as a user with the JIRA System Administrators global permission.
- Click the 'cog' icon on the top bar and select Add-ons.
- Click Manage Add-ons in the left menu.
- In the 'Filter visible add-ons' box, enter 'jira agile', then expand the 'JIRA Agile' entry in the filtered results.
- Click the pencil icon next to the License Key field to make it editable.
- Paste your license into the License Key field and click Update. You can copy your JIRA Agile license from https://my.atlassian.com, where you can either generate a new Evaluation License Key, or retrieve your old License Key if you already have one.
JIRA Agile license must match JIRA license
Step 3. Start JIRA Agile
Click the Agile tab to go to JIRA Agile.
Step 4. Configure JIRA Agile
To configure JIRA Agile, read the JIRA Agile 101 Guide.
About language support
English, French, German, Japanese, Dutch and Spanish are currently supported for JIRA Agile. Almost all character sets (like Cyrillic, Greek...) are supported for input. More languages will be supported in future releases. For details, please see Atlassian Translations.
Important note about custom fields: the language in which JIRA Agile custom fields are created is the default JIRA language (not the Java locale) at the time that you install JIRA Agile. Since custom fields are locked, you cannot change the language other than using the workaround in GHS-10356.
Upgrading JIRA Agile
Before you begin, please read the latest Release Notes and version-specific Upgrade Notes, and ensure that you are running a version of JIRA that is compatible with your new version of JIRA Agile.
To upgrade JIRA Agile:
- Log in to JIRA as a user with the 'JIRA System Administrators' global permission.
- Click the 'cog' icon on the top bar (or click Administation if using an older version of JIRA) and select Add-ons. The Universal Plugin Manager (UPM) page will be displayed.
On the Manage Add-ons page, look in the Add-Ons Requiring Action section and locate JIRA Agile .
Click the Update button.
If your JIRA instance is on a server that cannot access the internet, you will need to download the JIRA Agile add-on separately (from the Atlassian Marketplace) and install the add-on file by upload, as described here: Installing Marketplace apps.
Disabling JIRA Agile
- Log in to JIRA as a user with the 'JIRA System Administrators' global permission.
- Click the 'cog' icon on the top bar (or click Administation if using an older version of JIRA) and select Add-ons. The Universal Plugin Manager (UPM) page will be displayed.
- On the Purchased Add-ons page, click Check for Purchases then locate JIRA Agile .
- Click the Manage button. The details for the JIRA Agile add-on will display.
- Click the Disable button.
Getting Help
You may wish to check out the Atlassian Answers for JIRA Agile for advice from other users. If you need further assistance from us to resolve a problem, please log an issue on our support system.