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

Skip to end of metadata
Go to start of metadata

(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

  • 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.
    (warning) If you are using a version of JIRA prior to 6.0, please use these instructions instead of the page you are currently reading.
  • 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 add-ons will not cause any damage to your JIRA data.

On this page:

Related pages:

Installing GreenHopper

Installing the GreenHopper Add-on

  1. Log in to JIRA as a user with the 'JIRA System Administrators' global permission.
  2. 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.
  3. On the Find new add-ons page, type 'GreenHopper' in the search box.
  4. The GreenHopper 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.

Entering your GreenHopper License

  1. Log in as a user with the 'JIRA System Administrators' global permission.
  2. 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.
  3. On the Purchased Add-ons page, click Check for Purchases then locate GreenHopper.
  4. Click the Manage button. The details for the GreenHopper add-on will display.
    (info) Your Support Entitlement Number (SEN) is also shown on this screen.
  5. Paste your license into the License Key field and click Update.
    (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 to JIRA as a user with the 'JIRA System Administrators' global permission.
  2. 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.
  3. On the Manage Add-ons page, look in the Add-Ons Requiring Action section and locate GreenHopper.

  4. Click the Update button.

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

Disabling GreenHopper

  1. Log in to JIRA as a user with the 'JIRA System Administrators' global permission.
  2. 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.
  3. On the Purchased Add-ons page, click Check for Purchases then locate GreenHopper.
  4. Click the Manage button. The details for the GreenHopper add-on will display.
  5. 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.