Set up a GitHub account

Add an existing account by signing in to GitHub

1. Press Ctrl+Alt+S to open settings and then select Version Control | GitHub.

2. Click Add and select Log In via GitHub.

3. Enter your GitHub credentials in the browser window that opens. If you have two-factor authentication enabled, you will be asked to enter a code that will be sent to you by SMS or through the mobile application.

   The authorization is done using the OAuth 2.0.

Add an existing account with a token

1. Press Ctrl+Alt+S to open settings and then select Version Control | GitHub.

2. Click Add and select Log In with Token.

3. Do one of the following:

   • If you already have a token, insert it in the Add GitHub Account dialog window:

     

   • If you want to obtain a new token, click Generate.

     Enter your GitHub credentials in the browser window that opens. If you have two-factor authentication enabled, you will be asked to enter a code that will be sent to you by SMS or through the mobile application.

     In the token generation page, make sure that the repo, the gist and the read:org scopes are enabled (refer to Understanding scopes).

     Click Generate token, copy the token, and paste it into the Add GitHub Account dialog window.

4. Click Add Account.

See Creating a personal access token for more details on GitHub tokens.

Log in to a GitHub Enterprise account

1. Press Ctrl+Alt+S to open settings and then select Version Control | GitHub.

2. Click Add and select Log In to GitHub Enterprise.

3. In the Server field, enter the URL of your GitHub Enterprise server. For example, github.com for GitHub Enterprise Cloud, example.ghe.com for GitHub Enterprise Cloud (with Data Residency), or the URL of the self-hosting server that your company uses.

4. Do one of the following:

   • If you already have a token, insert it in the Add GitHub Account dialog window:

     

   • If you want to obtain a new token, click Generate.

     Enter your GitHub credentials in the browser window that opens. If you have two-factor authentication enabled, you will be asked to enter a code that will be sent to you by SMS or through the mobile application.

     In the token generation page, make sure that the repo, the gist and the read:org scopes are enabled (refer to Understanding scopes).

     Click Generate token, copy the token, and paste it into the Add GitHub Account dialog window.

5. Click Add Account.

Update an expired token

1. When your token expires, you see the following warning when trying to push changes to the GitHub repository:

   

   Click Use Token.

2. Do one of the following:

   • If you already have a token, insert it in the Log In to GitHub dialog window:

     

   • If you want to obtain a new token, click Generate.

     Enter your GitHub credentials in the browser window that opens. If you have two-factor authentication enabled, you will be asked to enter a code that will be sent to you by SMS or through the mobile application.

     In the token generation page, make sure that the repo, the gist and the read:org scopes are enabled (refer to Understanding scopes).

     Click Generate token, copy the token, and paste it into the Log In to GitHub dialog window.

3. Click Log In

Create a new GitHub account

1. Press Ctrl+Alt+S to open settings and then select Version Control | GitHub.

2. Click Add and select Log In via GitHub.

3. In the browser window that opens, click Create an account and complete the registration process on GitHub.

4. Return to the DataGrip settings, click Cancel, and then repeat steps 2 and 3.

5. Click Authorize JetBrains in your browser.

Manage multiple GitHub accounts

You can use multiple GitHub accounts in DataGrip: for example, a personal account to work on an open-source project, and a corporate account for your main job.

1. Press Ctrl+Alt+S to open settings and then select Version Control | GitHub.

2. Use Add to add as many accounts as you need.

3. (Optional) To set an account as a default one for the current project, select it and click Set as Default. If a default account is set, DataGrip will not ask you to select an account you want to use when you share your project on GitHub, rebase a fork, create a pull request, or create a gist.