As of June 1, 2015, the IDE Connector documentation will no longer be maintained by Atlassian. See https://developer.atlassian.com/blog/2015/06/discontinuing-ide-connectors-support/
for more information. We will also be making this documentation available for our open source community here: http://atlassian-docs.bitbucket.org/
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.
Atlassian Products |
|
|---|---|
| |
| |
| |
Eclipse IDE |
|
Eclipse IDE (2) |
|
Mylyn |
|
| |
Operating Systems |
|
Microsoft Windows (including 64-bit) |
|
Linux (x86/GTK) |
|
Apple Mac OS X |
|
5.0+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:
- Open the Eclipse software updates manager via 'Help', 'Install New Software'.
- Click 'Add'. The 'Add Site' window will display.
- Enter the details of the update site (see Eclipse Update Sites section above) and click 'OK'.
- The 'Available Software' screen will appear again. Select 'All Available Sites' in the 'Work with' dropdown list.
- Select both 'Atlassian Connector' categories:
- Click 'Next' and follow the installation prompts.
- Restart Eclipse when prompted.
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
JIRA Compatibility note
Atlassian Connector 3.2.x is compatible with JIRA 5.0 and newer.
Atlassian Connector 3.2.x consumes JIRA REST API instead of the old SOAP, RSS, WEB API used in version 3.0.8 and earlier.
JIRA REST API allows to retrieve more information from JIRA and gives more flexibility when comes to issue update. It allowed to significantly improve custom fields support. Issue editor is now able to display most of the custom field types and allows to edit them.
JIRA authentication note
Atlassian Connector 3.2.x uses HTTP Authentication to connect to JIRA instead of form authentication used in version 3.0.8 and earlier.
If your JIRA server is running behind a reverse proxy, and the reverse proxy requires separate HTTP authentication, the credentials for the reverse proxy must match the credentials for JIRA. Please also make sure that reverse proxy does not remove Authorization: header from the HTTP request.
For more information see release notes.
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).
- Download the Atlassian connector's from
- zipped update site (version 3.2.x) - the same file for Eclipse 3.7, 4.2, 4.3, 4.4 or
- zipped update site (version 3.0.x) and JIRA below 5.0 or
- old zipped update site for Eclipse 3.6 and 3.5 or
- nightly zipped update site (latest version 3.2.x) - the same file for Eclipse 3.7, 4.2, 4.3, 4.4
- In Eclipse, open 'Help, 'Install New Software', 'Add', click the 'Archive' button and select the downloaded zip file.
- Continue with the installation steps as described for the regular update site — see instructions below.
Installing a Previous Version
Atlassian does not support older releases of the plugin.
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:
Related topics
- 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
Overview
Content Tools
Apps