Tutorial: Create Jira credentials
This tutorial shows you how to create Jira credentials. You can use your new Jira credentials to configure the Jira issues integration in GitLab for Jira Data Center or Jira Server.
To create Jira credentials, here’s what we’re going to do:
Prerequisites:
- You must have at least the
Jira Administrators
global permission.
Create a Jira user
To create a Jira user:
On the top bar, in the upper-right corner, select Administration ( ) > User management.
Create a new user account with write access to your Jira projects.
Alternatively, you can use an existing user account, provided the user belongs to a Jira group that has been granted the
Administer Projects
permission scheme.- In Email address, enter a valid email address.
- In Username, enter
gitlab
. - In Password, enter a password (the Jira issues integration does not support SSO such as SAML).
Select Create user.
Now that you’ve created a user named gitlab
, it’s time to create a group for the user.
Create a Jira group for the user
To create a Jira group for the user:
- On the top bar, in the upper-right corner, select Administration ( ) > User management.
- On the left sidebar, select Groups.
- In the Add group section, enter a name for the group (for example,
gitlab-developers
), then select Add group. - To add the
gitlab
user to the newgitlab-developers
group, select Edit members. Thegitlab-developers
group appears as a selected group.
- In the Add members to selected group(s) section, enter
gitlab
.
- Select Add selected users.
The
gitlab
user appears as a group member.
Now that you’ve added the gitlab
user to a new group named gitlab-developers
,
it’s time to create a permission scheme for the group.
Create a permission scheme for the group
To create a permission scheme for the group:
- On the top bar, in the upper-right corner, select Administration ( ) > Issues.
- On the left sidebar, select Permission schemes.
- Select Add permission scheme.
- On the Add permission scheme dialog:
- Enter a name for the scheme.
- Optional. Enter a description for the scheme.
- Select Add.
- On the Permission schemes page, in the Actions column, select Permissions for the new scheme.
- Next to Administer Projects, select Edit.
- On the Grant permission dialog, for Granted to, select Group.
- From the Group dropdown list, select
gitlab-developers
, then select Grant.
You’ve done it! You can now use your new Jira username and password to configure the Jira issues integration in GitLab for Jira Data Center or Jira Server.
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support