GitLab

Last modified: 12 September 2023

GitLab settings: Settings | Version Control | GitLab

Required plugins: Git and GitLab (bundled and enabled by default)

With PyCharm, you can:

note

Currently, the integration supports GitLab Enterprise Edition versions 15.10 and above. Future updates will expand the range of supported versions, as well as add support for GitLab Community Edition.

Manage GitLab accounts

To retrieve data from a project hosted on GitLab or share your projects, you need to log in to your GitLab account in PyCharm.

Log in to GitLab

  1. Press to open the IDE settings and then select Version Control | GitLab.

  2. Click the Add button. The Log In with Access Token dialog will open:

    Log In with Access token dialog

  3. In the dialog, do one of the following:

    • If you already have a token, insert it in the Token field.

    • If you have no token, click Generate.

      In the token generation page that opens, make sure that the api and read_user scopes are selected.

      Click Create personal access token, copy the token, and paste it into the Log In with Access Token dialog window.

  4. Click Log In.

See Personal access tokens for more details on GitLab tokens.

Manage multiple GitLab accounts

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

  1. Press to open the IDE settings and then select Version Control | GitLab.

  2. Use the add icon button to add as many accounts as you need.

  3. To set an account as the default one for the current project, select it and click the Check button.

    Check button that sets the default account