Documentation for GreenHopper 6.1.x. Documentation for other versions of JIRA Agile is available too.
GreenHopper is now called JIRA Agile. Learn more.

(warning) The information on this page does not apply to Atlassian OnDemand. If you are using Atlassian OnDemand then you do not need to install GreenHopper, as it is supplied under Atlassian's Hosted Commercial Add-ons program. You may order and manage your GreenHopper OnDemand licenses by logging into your account at http://my.atlassian.com.

Before you begin

Please note the following information before you install/upgrade/remove GreenHopper:

  • You must have the 'JIRA System Administrators' global permission before you can carry out the instructions on this page.
  • Please check the Supported Platforms to ensure your version of JIRA supports the intended GreenHopper version.
  • Check for any known issues in the GHKB.
  • Please allocate an extra 256M of RAM to JIRA, just for GreenHopper — ie. please allocate a minimum of 512M to JIRA, instead of 256M. For details on how to do this, please see: Increasing JIRA Memory.
  • Internet Explorer 6 is not supported. If you are currently using Internet Explorer 6, 7 or 8, we strongly recommend that you upgrade to Internet Explorer 9. If you cannot upgrade, you may want to consider installing Google Chrome Frame instead.

(info) Please note: GreenHopper does alter JIRA database tables to support project templates. Further, GreenHopper will add additional tables to the JIRA database. Enabling or disabling GreenHopper within your installed plugins will not cause any damage to your JIRA data.

On this page:

Related pages:

Installing GreenHopper

Installing the GreenHopper Plugin

Installing GreenHopper is no different to installing any other JIRA plugin (see Managing JIRA's Plugins):

  1. Log in to JIRA as a user with the 'JIRA System Administrators' global permission.
  2. Click the Administration link on the top bar to open the JIRA administration console.
  3. Select Plugins > Plugins. The Universal Plugin Manager (UPM) page will be displayed (see Managing JIRA's Plugins).
  4. Click the Install tab in the UPM. The Find new plugin page will display, showing the featured plugins available for JIRA.
  5. Type 'GreenHopper' in the Search the Plugin Exchange box and click the Search button.
  6. The GreenHopper plugin will appear in the Featured Plugins section on the Install tab. Click the Install button. A confirmation message and the plugin details will display, if it is installed successfully.
  7. Restart JIRA.

Entering your GreenHopper License

To enter your GreenHopper License details:

  1. Log in as a user with the 'JIRA System Administrators' global permission.
  2. Click the Administration link on the top bar.
  3. Select Plugins > Plugins. The Universal Plugin Manager page will be displayed (see Managing JIRA's Plugins).
  4. Click the GreenHopper section to expand it.
  5. Paste your license into the License Key field and click Add.
    (info) You can copy your GreenHopper 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.

(info) If you need to change your GreenHopper license details at any time in the future, please refer to Specifying your License Details.

GreenHopper license must match JIRA license

Please note, if you are using a commercial (i.e. not an evaluation) license for GreenHopper, it must match your JIRA license. For example, if you have a JIRA 25 User Commercial license you must have a GreenHopper 25 User Commercial license. GreenHopper evaluation licenses do not need to match JIRA licenses.

Starting GreenHopper

Click the 'Agile' tab to go to GreenHopper.

Configuring GreenHopper

To configure GreenHopper, read the GreenHopper 101 Guide.

Which languages are supported?

For now, English, French, German, Japanese, Dutch and Spanish are supported. Almost all character sets (like Cyrillic, Greek...) are supported in the inputs. More languages will be supported in future releases. For more details please see Atlassian Translations



Upgrading GreenHopper

(warning) 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 GreenHopper.

To upgrade GreenHopper:

  1. Log in as a user with the 'JIRA System Administrators'global permission.
  2. Click the 'Administration' link on the top bar to open the JIRA administration console.
  3. Select 'System > Plugins' to open the 'Universal Plugin Manager'. The 'Universal Plugin Manager' will be displayed, showing the plugins installed on your JIRA instance.

  4. On the 'Manage My Plugins' tab, check the 'Available Updates' section and locate 'GreenHopper'.

  5. Click the 'Update' button.

(info) To upgrade GreenHopper manually (e.g. if your GreenHopper system does not have internet access), please download the GreenHopper plugin then follow the manual installation instructions at Installing Marketplace apps.

Disabling GreenHopper

To disable GreenHopper:

  1. Log in as a user with the 'JIRA System Administrators' global permission.
  2. Click the 'Administration' link on the top bar to open the JIRA administration console.
  3. Select 'System > Plugins' to open the 'Universal Plugin Manager'. The 'Universal Plugin Manager' will be displayed, showing the plugins installed on your JIRA instance.
  4. Click the 'Manage Existing' tab. The plugins currently installed in JIRA will be displayed.
  5. Click the GreenHopper plugin. The details for the GreenHopper plugin will display.
  6. Click the 'Disable' button.

Getting Help

You may wish to check out the Atlassian Answers for GreenHopper for advice from other users. If you need further assistance from us to resolve a problem, please log an issue on our support system.



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.