This page last changed on Feb 11, 2009 by smaddox.
This page tells you how to configure your Atlassian IntelliJ Connector within IntelliJ IDEA. Before following the steps below, please make sure that you have installed the connector, as described in the Installation Guide.
The connector configuration panels display the version number and the SVN repository version of the Atlassian IntelliJ Connector that you are currently using.
The Atlassian IntelliJ Connector stores configuration settings at two levels in IntelliJ IDEA:
- Server connections are stored as project settings in IntelliJ IDEA. Project settings allow you to share the same server connections with other members of your project team. Additionally, if you work on more than one project, this allows you to configure different servers for each project. Project-level settings can be stored in your source control repository, so that the connector will load the settings at the same time as loading the project into IDEA.
- Other options are stored as IDE settings in IntelliJ IDEA. IDE settings allow each developer to configure their own workspace-specific settings, such as polling intervals and the behaviour of notification popups.
On this page:
Configuring Servers and Display Options
Configuring your JIRA Server Connections
To configure your JIRA server connection(s):
- Go to the 'Project Settings' for the 'Atlassian Connector', by doing one of the following:
- Open the IDEA 'Settings' dialogue, then go to the 'Project Settings' section and click the 'Atlassian Connector' icon.
- Or you can click the configuration icon
on your connector window.
- Go to the 'Servers' tab.
To add a JIRA server:
- Click the plus icon
on the configuration panel.
- A list of server types will appear. Select 'Add JIRA Server'.
- A form will appear. Enter the information as follows:
- 'Server Enabled' — Leave this checkbox ticked (default). If necessary, you can remove the tick to disable particular servers without deleting them. This is useful if your servers are behind a firewall and you don't have access to them.
- 'Server Name' — A description of your JIRA server.
- 'Server URL' — The address of your JIRA server.
- 'Username' and 'Password' — The login name and password you use to access the JIRA server.
- Remember Password — Put a tick in the checkbox if you want to save your password on disk. Leave the checkbox unticked if you want to be asked for a password every time you start your IDE.
If you choose to remember the password, it is stored in a Base64 encoding, so it is not really secure.
- Click the 'Test Connection' button to check that the connection to the server works.
- Click 'Apply' to save your changes and continue with server configuration, or 'OK' to save your changes and close the configuration tab.
- Click the 'Defaults' tab to set your default server (if you have defined more than one JIRA server) and default project.
- Now you can configure the JIRA options, as described below.
You can add more than one JIRA server.
Configuring your JIRA Options
- Open the IDEA 'Settings' dialogue, then go to the 'IDE Settings' section and click the 'Atlassian Connector' icon.
- Define the maximum number of issues that the connector will show on each screen. At display time, if there are more issues than specified here, the connector will display a 'Get More Issues...' link allowing you to retrieve the next batch of issues from the server.
Screenshot: Configuring JIRA server connections
Screenshot: Configuring JIRA IDE options

Configuring your Bamboo Server Connections
To configure your Bamboo server connection(s):
- Go to the 'Project Settings' for the 'Atlassian Connector', by doing one of the following:
- Open the IDEA 'Settings' dialogue, then go to the 'Project Settings' section and click the 'Atlassian Connector' icon.
- Or you can click the configuration icon
on your connector window.
- Go to the 'Servers' tab.
To add a Bamboo server:
- Click the plus icon
on the configuration panel.
- A list of server types will appear. Select 'Add Bamboo Server'.
- A form will appear. Enter the information as follows:
- 'Server Enabled' — Leave this checkbox ticked (default). If necessary, you can remove the tick to disable particular servers without deleting them. This is useful if your servers are behind a firewall and you don't have access to them.
- 'Server Name' — A description of your Bamboo server.
- 'Server URL' — The address of your Bamboo server.
- 'Username' and 'Password' — The login name and password you use to access the Bamboo server.
- Remember Password — Put a tick in the checkbox if you want to save your password on disk. Leave the checkbox unticked if you want to be asked for a password every time you start your IDE.
If you choose to remember the password, it is stored in a Base64 encoding, so it is not really secure.
- Click the 'Test Connection' button to check that the connection to the server works. A list of build plans will appear.
- If your Bamboo build server is located in a different time zone than you, you can manually adjust the 'Time Zone Difference'. You should specify a positive difference if your time is ahead of your build server (e.g. you are in Russia and the build server is in the UK). You should specify a negative difference if your time is behind your build server (e.g. you are in the US and your build server is in Spain).
- Now select the Build Plans that the connector will watch. You can either select plans manually from the list of plans defined on the Bamboo server, or simply use your favourite plans as defined on the server. Your favourite plans are marked with a yellow star
.
- Click 'Apply' to save your changes and continue with server configuration, or 'OK' to save your changes and close the configuration tab.
- Now you can configure the Bamboo options, as described below.
You can add more than one Bamboo server.
Configuring your Bamboo Options
- Open the IDEA 'Settings' dialogue, then go to the 'IDE Settings' section and click the 'Atlassian Connector' icon.
- Define the behaviour of the popup window that is shown when the status of the build changes. (See Working with Bamboo Builds in IDEA.)
- Set the polling interval that the connector will use to monitor build plans on all defined Bamboo servers. Specify the value in minutes.
Configuring your Crucible Server Connections
To configure your Crucible server connection(s):
- Go to the 'Project Settings' for the 'Atlassian Connector', by doing one of the following:
- Open the IDEA 'Settings' dialogue, then go to the 'Project Settings' section and click the 'Atlassian Connector' icon.
- Or you can click the configuration icon
on your connector window.
- Go to the 'Servers' tab.
To add a Crucible server:
- Click the plus icon
on the configuration panel.
- A list of server types will appear. Select 'Add Crucible Server'.
- A form will appear. Enter the information as follows:
- 'Server Enabled' — Leave this checkbox ticked (default). If necessary, you can remove the tick to disable particular servers without deleting them. This is useful if your servers are behind a firewall and you don't have access to them.
- 'Server Name' — A description of your Crucible server.
- 'Server URL' — The address of your Crucible server.
- 'Username' and 'Password' — The login name and password you use to access the Crucible server.
- Remember Password — Put a tick in the checkbox if you want to save your password on disk. Leave the checkbox unticked if you want to be asked for a password every time you start your IDE.
If you choose to remember the password, it is stored in a Base64 encoding, so it is not really secure.
- Click the 'Test Connection' button to check that the connection to the server works.
- If your Crucible server is linked to a FishEye server, put a tick in the checkbox labelled 'Crucible Server Contains FishEye Instance'. Remember to set up your FishEye defaults, as described in Configuring your FishEye Options in IDEA.
Don't worry if you do not have a FishEye server. There is very little effect on the connector's functionality. The only think you will not be able to do, is to access a FishEye diff view of the source code under review.
- Click 'Apply' to save your changes and continue with server configuration.
- Click the 'Defaults tab to set up a default Crucible server, project and repository. These defaults will be used when you create a review directly from your source within IDEA.
- Now you can configure the Crucible options, as described below.
You can add more than one Crucible server.
Configuring your Crucible Options
- Open the IDEA 'Settings' dialogue, then go to the 'IDE Settings' section and click the 'Atlassian Connector' icon.
- Define the behaviour of the popup window that is shown when someone adds a Crucible review that affects you. (See Working with Crucible Reviews in IDEA.)
- Set the polling interval that the connector will use to monitor all defined Crucible servers. Specify the value in minutes.
Configuring FishEye and Crucible Connections on Same Server
If you have FishEye and Crucible running on the same server, then you can use your Crucible server configuration for the connector's FishEye functionality too:
- Simply put a tick in the checkbox labelled 'Crucible Server Contains FishEye Instance' on the Crucible server configuration screen.
- Then set up your FishEye defaults, as described below.
Crucible server configuration is described in full in Configuring your Crucible Options in IDEA.
You can add more than one Crucible and/or FishEye server.
Configuring a Separate FishEye Server Connection
To configure a FishEye server connection independently of Crucible:
- Go to the 'Project Settings' for the 'Atlassian Connector', by doing one of the following:
- Open the IDEA 'Settings' dialogue, then go to the 'Project Settings' section and click the 'Atlassian Connector' icon.
- Or you can click the configuration icon
on your connector window.
- Go to the 'Servers' tab.
- Click the plus icon
on the configuration panel.
- A list of server types will appear. Select 'Add FishEye Server'.
- A form will appear. Enter the information as follows:
- 'Server Enabled' — Leave this checkbox ticked (default). If necessary, you can remove the tick to disable particular servers without deleting them. This is useful if your servers are behind a firewall and you don't have access to them.
- 'Server Name' — A description of your FishEye server.
- 'Server URL' — The address of your FishEye server.
- 'Username' and 'Password' — The login name and password you use to access the FishEye server.
- Remember Password — Put a tick in the checkbox if you want to save your password on disk. Leave the checkbox unticked if you want to be asked for a password every time you start your IDE.
If you choose to remember the password, it is stored in a Base64 encoding, so it is not really secure.
- Click the 'Test Connection' button to check that the connection to the server works.
- Click 'Apply' to save your changes and continue with server configuration.
- Click the 'Defaults tab and set up your FishEye defaults.
It is important to configure your FishEye defaults correctly. These values will be used to construct the path when you attempt to open a source file from IDEA in FishEye's web interface. See Working with your FishEye Repository View in IDEA. Set the default values as follows:
- Server — Select one of your FishEye connections.
- Repository — Select the repository where your source files reside. These are the source files you will be working on most often in IDEA.
- Path to Project — Enter the path to the root of the project in your repository. For example, the path may be one of the following:
- blank, if your project is at the root of the repository.
- trunk/
- trunk/myproject
Example of Default Repository and Path
Let's assume:
- Your FishEye instance is located at:
http://example.com/fisheye
- You have a repository called my_project.
- You are working under the trunk directory under this project.
Your settings will be:
Default Repository |
my_project |
Path to Project |
trunk/ |
Removing a Server Connection
To remove a server from the list:
- Select the server.
- Click the minus icon
on the configuration panel.
Configuring General Options
Screenshot: General tab of the connector IDE Settings panel

The 'General' tab is used to define the upgrade options for your connector, configure an HTTP proxy and set other options as described below.
Automatic Upgrade
The connector's auto-upgrade feature, if enabled, will prompt you to install the most recent version of the connector when available.
To configure the connector's auto-upgrade feature:
- Put a tick in the 'Enabled (stable version)' checkbox to enable the connector auto-upgrade feature. The connector will check for the latest available stable (released) version of the connector.
- Put a tick in the 'Check snapshot versions' checkbox if the auto-upgrade should include unstable (development) versions of the connector as well as stable versions.
Manual Upgrade
To check immediately for the latest version of the connector:
- Select one of the radio buttons as follows:
- Stable only — The connector will check for the latest available stable (released) version of the connector.
- Stable + snapshot — The connector will check for the latest version, including unstable (development) versions of the connector as well as stable versions.
- Click the 'Check now' button.
For more details, refer to Upgrading the IntelliJ Connector.
HTTP Proxy
You can configure the connector to use IDEA's proxy settings or to bypass IDEA's proxy settings altogether. If the connector is using IDEA's proxy settings, you can configure the settings here too.
To use IDEA's proxy settings:
- Select the 'Use IDEA proxy settings' radio button.
- Click the 'Edit IDEA proxy settings' button. A dialogue will appear, similar to this screenshot:

- Enter the required settings and click the 'OK' button. If your proxy requires a domain name in addition to username, enter the information in the format domain\user.
- Restart IDEA for your changes to take effect.
Collection of Statistics
Put a tick in the 'Report anonymous usage statistics' checkbox if you are happy for us to collect information on the connector usage. If you agree to take part, the connector will send Atlassian the unique ID generated by the connector on its first installation. No other information is collected.
This feature is disabled by default. When you first open the connector configuration panel, we also ask you to decide whether you agree to participate in the statistics collection.
Reporting Bugs and Requesting New Features
Click the following links on the Project Settings or IDE Settings panel:
- Report Bug — This will open a bug-creation page in the connector's JIRA issue tracker. It will automatically populate the connector version number and details of the environment (Java version and vendor, OS details, build number of your IDE).
- Request Feature — This will open an issue-creation page of the 'Story' type in the connector's JIRA issue tracker. Use this issue type to request new connector functionality.
Getting Help
Click the 'Help' link on the Project Settings or IDE Settings panel. This will open the online documentation page which tells you how to configure the connector — namely, this page. From here, you can click the links to view other online documentation pages.
If you're looking for support or other help, please take a look at the links on our documentation home page.
RELATED TOPICS
Installation and Upgrade Guide for the IntelliJ Connector
Using JIRA in the IntelliJ Connector
Using Bamboo in the IntelliJ Connector
Using Crucible in the IntelliJ Connector
|