Atlassian IDE Connectors : Installing the Eclipse Connector

Below are the system requirements and installation instructions for the Atlassian Connector for Eclipse.

On this page:

System Requirements

The following platforms are supported for the Atlassian Connector for Eclipse. Please see Supported Platforms - Atlassian Connector for Eclipse for further details.

Notes

• JIRA: Connector 3.0.8 and earlier, requires JIRA SOAP/RPC services running on the JIRA server (i.e. enable the RPC plugin).
• Mylyn: If you do not already have Mylyn, it will be installed automatically when you install one of the Atlassian Connector's features. If you already have Mylyn installed, please check your version of Mylyn. If your version of Mylyn is earlier than 3.8.4, please upgrade to Mylyn 3.8.4 or newer.

Installation via the Eclipse Marketplace for Eclipse 3.7 (Indigo), 4.2 (Juno), 4.3 (Kepler), 4.4 (Luna)

You can install the Atlassian Connector for Eclipse via Eclipse Marketplace Client. Simply launch the Eclipse Marketplace Client ('Help' -> 'Eclipse Marketplace'), search for 'Atlassian' and follow the prompts to install.

Screenshot: Installing the Atlassian Connector for Eclipse via the Eclipse Marketplace Client

Installation via update site for Eclipse 3.7 (Indigo), 4.2 (Juno), 4.3 (Kepler), 4.4 (Luna)

You can also install the Connector via the Eclipse software updates manager, as described below.

To install the connector on a clean Eclipse IDE for Java Developers:

1. Open the Eclipse software updates manager via 'Help', 'Install New Software'.
2. Click 'Add'. The 'Add Site' window will display.
3. Enter the details of the update site (see Eclipse Update Sites section above) and click 'OK'.
4. The 'Available Software' screen will appear again. Select 'All Available Sites' in the 'Work with' dropdown list.
5. Select both 'Atlassian Connector' categories:
   
   
6. Click 'Next' and follow the installation prompts.
7. Restart Eclipse when prompted.

Installation from the command line

Eclipse plugins can be installed from the command line without UI. That method allows to automate the installation process and is really useful when you want to repeat the installation several times (e.g. install plugin on many workstations).

Example usage:

./eclipse -nosplash -application org.eclipse.equinox.p2.director -repository http://update.atlassian.com/atlassian-eclipse-plugin/rest/nightly/e3.7 -installIU com.atlassian.connector.eclipse.feature.group

More details on the available options can be found on the Eclipse knowledge base pages: http://help.eclipse.org/juno/index.jsp?topic=/org.eclipse.platform.doc.isv/guide/p2_director.html

Eclipse Update Sites

Add the following URL to your Eclipse update sites:

• Atlassian Connector 3.2.x for Eclipse 3.7 (Indigo), 4.2 (Juno), 4.3 (Kepler), 4.4 (Luna) — http://update.atlassian.com/atlassian-eclipse-plugin/rest/e3.7

There is also nightly update site available, for those who are keen to get the latest version of the connector. Builds are executed every night:

• Atlassian Connector 3.2.x for Eclipse 3.7 (Indigo), 4.2 (Juno), 4.3 (Kepler), 4.4 (Luna) — http://update.atlassian.com/atlassian-eclipse-plugin/rest/nightly/e3.7
  
  

Offline Installation

If you cannot use our update site (e.g. due to firewall issues) or just prefer local installation, we offer a zipped version of the entire update site (you still may need to install Mylyn first as it is required by Atlassian Connector and not bundled in the zip).

1. Download the Atlassian connector's from
   
   1. zipped update site (version 3.2.x)  - the same file for Eclipse 3.7, 4.2, 4.3, 4.4 or
   2. zipped update site (version 3.0.x) and JIRA below 5.0 or
   3. old zipped update site for Eclipse 3.6 and 3.5 or
   4. nightly zipped update site (latest version 3.2.x) - the same file for Eclipse 3.7, 4.2, 4.3, 4.4
2. In Eclipse, open 'Help, 'Install New Software', 'Add', click the 'Archive' button and select the downloaded zip file.
3. Continue with the installation steps as described for the regular update site — see instructions below.

Installing a Previous Version

Add the following URL to your Eclipse update sites:

• For JIRA [ 3.13.x,  5.0) and Eclipse 3.7, 4.2, 4.3 (the last compatible version of the connector is 3.0.8) — http://update.atlassian.com/atlassian-eclipse-plugin/e3.6
• For Eclipse 3.5 and 3.6 (the last compatible version of the connector is 3.0.0) — http://update.atlassian.com/atlassian-eclipse-plugin/3.0.0/e3.5
• For Eclipse 3.4 (the last compatible version of the connector is 2.1.0) — http://update.atlassian.com/atlassian-eclipse-plugin/2.1.0/e3.4
• For Eclipse 3.3 (the last compatible version of the connector is 1.2.0) — http://update.atlassian.com/atlassian-eclipse-plugin/1.2.0/e3.3

The last version of the connector containing Crucible support is 2.3.0:

• For Eclipse 3.5 and 3.6 — http://update.atlassian.com/atlassian-eclipse-plugin/2.3.0/e3.5

Troubleshooting the Installation

Please refer to the list of installation FAQ:

• Installation Error - Cannot Find a Solution Satisfying the Following Requirements

Related topics

• Configuring the Eclipse Connector

• License and Copyright for the Eclipse Connector
• Installing the Eclipse Connector
• Upgrading the Eclipse Connector
• Upgrading from the JIRA Connector to the Atlassian Connector for Eclipse
• Atlassian Connector for Eclipse - Release Notes

• IDE Connector Documentation