Manage Sites

Each link to a Jenkins or Hudson application is known as a Site on the Jenkins Configuration page. 

Add Site

To add a new Jenkins or Hudson CI Site, simply click the Add Site button on top right to show the Add Site dialog, and:

  1. Selected the Type of the site.
  2. Provide a Name.
  3. Provide the Sync URL that should be used for synchronization and other background actions.


    (warning) For security purposes, only ports 80 443, 8080 and 8443, http and https respectively, are supported on Jira Cloud.
    (warning) The Jenkins counterpart add-on is required to be installed before the site can be added on Jira Cloud.
    (warning) If you're Jenkins site is behind a firewall or if you use whitelisting, then contact support for assistance.

  4. Optionally, provide a Display URL incase the RPC URL is not accessible by users and a different URL should be used in the UI features of the plugin.
  5. Optionally, check the Auto enable new Jobs checkbox if you want to enable all Jobs on the site by default, including future new jobs.
  6. Optionally, provide basic authentication details in the form of an Username and Token.
    (warning) If you use and external source (like LDAP, AD or Crowd) for authentication, Then it could be that you need to provide the API Token as password for the user.
     Where to find the API Token...

    The API Token is a password replacing token that users can use to authenticate with against Jenkins. This is mostly useful for users that have there accounts managed outside Jenkins.

    To get a token for an account, follow these steps:

    1.  Login on Jenkins using the username and password of the synchronization account
    2. Click on the Account Name in the top-right corner of the page after login
    3. Then click on the Configure link in the left menu
    4. The API Token can now be displayed by clicking on the Show API Token... button

Site Actions

Actions and configuration changes can be make per site using the Actions button next to the Site title.

Edit Site

To edit the details of a site, like name, authentication details, etc, simply click on the Edit button in the actions column. This wil show the Site edit dialog and form allowing you to update the details of the Site.

(warning) In order to change the authentication token, you will need to check the Change Token box to show the Token field.


(warning) If you use and external source (like LDAP, AD or Crowd) for authentication, Then it could be that you need to provide the API Token as password for the user.
 Where to find the API Token...

The API Token is a password replacing token that users can use to authenticate with against Jenkins. This is mostly useful for users that have there accounts managed outside Jenkins.

To get a token for an account, follow these steps:

  1.  Login on Jenkins using the username and password of the synchronization account
  2. Click on the Account Name in the top-right corner of the page after login
  3. Then click on the Configure link in the left menu
  4. The API Token can now be displayed by clicking on the Show API Token... button

Delete Site

To delete a Site, simply click the Delete button in the actions column and click the Delete button to delete the site.


This action is not reversible, and only the jobs and builds that are still available on the Site itself can be restored when the site is added at a later state.

Manage Jobs

To manage the jobs that are enabled for synchronization, simply click the Manage Jobs button in the actions column and make the nessassery updates by checking or unchecking jobs.

Refresh Jobs

The jobs listed on the Manage Jobs dialog are the jobs that are currently synchronized. This list will be automatically updated when Auto enable new Jobs is enabled for the site and a unknown job triggers a build completion event.

This process can be forced by clicking on the Refresh Jobs button in the Manage Jobs dialog.