DataGrip 2018.2 Help

Using Mercurial Integration

Install the Mercurial Integration plugin

To enable version control in DataGrip, install the Mercurial Integration plugin.

  1. Open Settings | Plugins.
  2. Click Install JetBrains plugin.
  3. In the Browse JetBrains Plugins window, type Mercurial Integration in the search field.
  4. To install the plugin, click Install and restart DataGrip.

With the Mercurial integration enabled, you can perform basic Mercurial operations from inside DataGrip.

In this section:


  • Mercurial is installed on your computer.
  • The location of the Mercurial executable file hg.exe is correctly specified on the Mercurial page of the Settings/Preferences dialog box.

    If you followed the standard installation procedure, the default location is /opt/local/bin or /usr/local/bin for Linux and macOS and /Program Files/TortoiseHG for Windows.

    It is recommended that you add the path to the Mercurial executable file to the PATH variable. In this case, you can specify only the executable name, the full path to the executable location is not required.

  • Mercurial integration is enabled for the current project root or directory.

If you want to use a remote repository, create a Mercurial hosting account first. You can access the remote repository through a pair of ssh keys or apply the username/password and keyboard interactive authentication methods supported by the Mercurial integration.

Mercurial support

  • When Mercurial integration with DataGrip is enabled, the Mercurial item appears on the VCS menu, and on the context menus of the Editor and the Files tool window.
  • The files in the folders under the Mercurial control are highlighted according to their status. See File Status Highlights for file status highlighting conventions.
  • Modifications results are shown in the Version Control tool window.
  • When using Mercurial integration, it is helpful to open the Version Control tool window. The Console tab displays the following data:
    • All commands generated based on the settings you specify through the DataGrip user interface.
    • Information messages concerning the results of executing generated Mercurial commands.
    • Error messages.
Last modified: 17 August 2018

See Also