Install and run DataGrip
Installation requirements
Hardware requirements
2 GB RAM minimum, 4 GB RAM recommended
500 MB hard disk space + at least 1 GB for caches
1024x768 minimum screen resolution
Software requirements
JRE 1.8 is bundled with the DataGrip distribution. You do not need to install Java on your computer to run DataGrip.
Windows | macOS | Linux |
---|---|---|
32-bit or 64-bit versions of Microsoft Windows 10, 8, 7 (SP1), or Vista (SP2) | macOS 10.8.3 or later |
|
Download and install DataGrip
Download DataGrip for your operating system.
Do the following depending on your operating system:
- Windows installation:
Run the .exe file you've downloaded.
Run the datagrip-*.exe file you've downloaded.
Follow the instructions in the installation wizard.
- macOS installation:
Open the .dmg package that you've downloaded, and drag DataGrip to the Applications folder.
Open the datagrip-*.dmg package that you've downloaded, and drag DataGrip to the Applications folder.
- Linux installation:
- Unpack the datagrip-*.tar.gz file to a different folder, if your current
Download
folder doesn't support file execution:tar xfz datagrip-*.tar.gz -C <new_archive_folder>The recommended installation location according to the filesystem hierarchy standard (FHS) is /opt. To install DataGrip into this directory, enter the following command:
sudo tar xfz datagrip-*.tar.gz -C /opt/ Switch to the bin subdirectory:
cd <new archive folder>/DataGrip-*/binFor example,cd /opt/DataGrip-*/binRun datagrip.sh from the bin subdirectory.
- Unpack the datagrip-*.tar.gz file to a different folder, if your current
- Windows installation:
Earlier DataGrip versions are available for download on the Previous DataGrip Releases page.
Run DataGrip for the first time
Import DataGrip settings
When you start DataGrip for the first time, or after you have upgraded it from a previous version, the Complete Installation dialog opens where you can select whether you want to import the IDE settings:
If this is your first instance of DataGrip, choose the Do not import settings option.
Select the user interface theme
Next, you will be prompted to select the UI theme. You can choose between the Default and the Darcula themes:
Select a preferred dialect for SQL files
On the next step, you are prompted to select a preferred dialect for SQL files. The selected dialect provides code assistance including syntax analysis, completion, and refactoring. If you plan to use different dialects, select <Generic SQL>
.
Also, on this step, you can select a directory with SQL scripts and attach it to your project. The directory and all subdirectories can be accessed in the Files tool window ( ).
Quick tour around the interface
By default, when you run DataGrip for the first time, some control elements are hidden. To access these elements, you must enable tool windows or perform certain actions (for example, run a query).
Tool windows in DataGrip are divided according to an area of development tasks or subtasks. By default, DataGrip includes the following tool windows:
Database(Alt+2): includes a list of data sources and all actions that are associated with them.
Files(N/A): displays a current scope for search and code inspection operations.
TODO(Alt+6): displays a list of TODO comments in a project.
Structure (Alt+7): displays a query structure.
Version Control(Alt+9): displays version control functionality. To use this tool window, install a corresponding VCS plugin. Read more about VCS plugins in Version control with DataGrip.
Database Changes: displays all changes that you make in a database, and logs all system and user queries.
Event Log: displays all system events.
Favorites: displays frequently-used objects that you added as favorite ( ).
Enable tool windows
To enable tool windows, perform one of the following actions:
-
Navigate to
and select necessary tool windows. Use a shortcut or assign a shortcut in
.Click icons of tool windows that are located along the IDE border.
Hover the pointer over the Tool windows widget.
Register DataGrip
To try and evaluate DataGrip, you can download and install its trial version for free. The trial version is available for 30 days, whereupon you need to obtain and register a license.
-
Do one of the following:
On the Welcome screen, click Configure | Manage License
From the main menu, select Help | Register
-
Select how you want to register DataGrip:
Option
Description
JetBrains Account Register using the JetBrains Account.
For more information, see What is JetBrains Account?
Activation code Register using an activation code.
License server Register using a License Server.
To override the URL of the system proxy during initial DataGrip startup, use the
-Djba.http.proxy
property, which can be added as a JVM option.When performing silent install or managing DataGrip installations on multiple machines, you can set the
JETBRAINS_LICENSE_SERVER
environment variable to point the installation to the license server URL.
If you have plugins that require a license, then instead of the License Activation dialog, open the Licenses dialog by clicking from the main menu.
The Licenses dialog contains a list of licenses and shows their states:
Expired: Renew your license to continue.
Grace period: You have several days until the license expires.
Evaluation period: Use without an active license.
Active license: Use until the expiry date.
To configure a license, click the Edit button, which opens the License Activation dialog.
Update DataGrip
Download the latest version of DataGrip.
Launch the setup as described in Download and install DataGrip.
Choose whether you want to uninstall the existing DataGrip version together with its settings, caches and local history and follow the instructions of the installation wizard.
Out of the box, standalone DataGrip installation is configured to check for updates automatically. It will notify you when a new version is available:
DataGrip updates are usually patch-based: they are applied to the existing installation and only require you to restart the IDE.
If the patch download takes a long time, you can send it to the background and continue working. Once download is complete, you will be prompted to restart, which should finalize the update.
If you do not want to install the proposed update for some reason, you can ignore it by clicking the Ignore This Update button in the update dialog. The ignored build's number will be added to the Ignored updates list, and you will not be prompted to install this particular build until you remove it from the list.
Manage DataGrip through Toolbox App
Toolbox App is a control panel that allows you to manage all JetBrains developer tools, including DataGrip, as well as your projects, from a single point of access. It lets you launch the IDEs, maintain different versions of the same tool, install updates and roll them back if needed. It also remembers your JetBrains Account and uses it to automatically log you in when you install and register new tools.
Launch the setup file.
When the installation is complete, accept the JetBrains privacy policy and sign in to your JetBrains Account.
Now you can manage existing tools, install new tools, and download updates:
Perform silent installation on Windows
Silent installation is performed without any user interface. It can be used by network administrators to install DataGrip on a number of machines and avoid interrupting other users.
To perform silent install, run the installer with the following switches:
-
/S
: Enable silent install -
/D
: Specify the path to the installation directory -
/CONFIG
: Specify the path to the silent configuration file -
/LOG
: (Optional) Use this switch to enable logging of issues during the installation process. You need to specify log file path and name.
For example:
Silent configuration file
You can download the silent configuration file for DataGrip at https://download.jetbrains.com/datagrip/silent.config
The silent configuration file defines options for installing DataGrip. With default options, silent installation is performed only for the current user (mode=user
). If you want to install DataGrip for all users, open the silent configuration file with a text editor, change the value of the installation mode option (mode=admin
) and run the installer as an administrator.
Uninstall DataGrip silently
To silently uninstall DataGrip, run the uninstaller with the /S
switch as an administrator. The uninstaller is located in the installation directory under bin.
Run cmd (Windows Command Prompt) as administrator, change to the DataGrip installation directory, and run the following:
Install DataGrip as a snap package on Linux
You can install DataGrip on Linux as a self-contained snap package. Since snaps update automatically, your DataGrip installation will always be up-to-date.
DataGrip is distributed via two channels:
-
The stable channel includes only stable versions. To install the latest stable release of DataGrip, run the following command:
$ sudo snap install datagrip --classic -
The edge channel includes EAP builds. To install the latest EAP build of DataGrip, run the following command:
$ sudo snap install datagrip --classic --edge
When the snap is installed, you can launch it by running the datagrip
command.
To list all installed snaps, run sudo snap list
. For more information, see the Snapcraft documentation.