DataGrip 2026.3 Help

Docker containers

Docker containers are runtime instances of the corresponding images. DataGrip uses Docker run configurations to execute the commands that build Docker images and run containers.

Run a container from an existing image

You can run a container from any locally existing Docker image that you either pulled or built previously.

  1. In the Services tool window, select an image and click The Create container button or select Create Container from the context menu.

    The Create container context menu item

  2. In the Create Container popup, click Create….

  3. In the Create Docker Configuration dialog that opens, you can provide a unique name for the configuration and specify a name for the container. If you leave the Container name field empty, Docker will give it a random unique name.

    The Create Docker Configuration dialog

  4. When you are done, click Run to launch the new configuration.

This creates and starts the Docker Image run configuration.

Run a container from a Dockerfile

  1. Open the Dockerfile from which you want to run the container.

  2. Click Run on Docker in the gutter and select to run the container from this Dockerfile.

    The Run on Docker popup

This creates and starts the Dockerfile run configuration with default settings, which first builds an image based on the Dockerfile and then runs a container based on this image.

To create a run configuration with custom settings, click Run on Docker in the gutter and select New Run Configuration…. You can specify a custom tag for the built image, as well as a name for the container, and a context folder from which to read the Dockerfile. The context folder can be useful, for example, if you have some artifacts outside the scope of your Dockerfile that you would like to add to the file system of the image.

Interacting with containers

Created containers are listed in the Services tool window. By default, the Services tool window displays all containers, including those that are not running. To hide stopped containers from the list, click The View Options button in the toolbar, select Docker, and then click Stopped Containers to remove the checkbox.

When you select a container, you can view the Build Log tab that shows the deployment log produced by the corresponding Docker run configuration while creating and starting the container.

The Build Log tab of a container selected in the Services tool window

The Dashboard tab provides important information about the container. Besides its name and hash ID, it also lists the environment variables, ports, and volume bindings. You can add, edit, and remove the environment variables, ports, and volume bindings. However, these changes require you to recreate the container and do not change in the Docker run configuration that is used to create this container. This means that the changes will not persist when you run the configuration next time.

The Dashboard tab of a container selected in the Services tool window

For more information, refer to Container dashboard.

Execute a command inside a running container

  1. In the Services tool window, right-click the container name and then click Exec.

  2. In the Run Command in Container popup, click Create and Run… to create and execute a new command.

    Alternatively, you can select one of the commands that you ran previously.

  3. In the Exec dialog, type the command and click OK. For example:

    ls /tmp

    List the contents of the /tmp directory

    mkdir /tmp/my-new-dir

    Create the my-new-dir directory inside the /tmp directory

    /bin/bash

    Start a bash session

    The Exec tab with /bin/bash running

For more information, refer to the docker exec command reference.

View detailed information about a running container

  • In the Services tool window, right-click the container name and then click Inspect.

    The output is rendered as a JSON object on the Inspection tab.

    The Inspection tab

For more information, refer to the docker inspect command reference.

View processes running in a container

  • In the Services tool window, right-click the container name and then click Show Processes.

    The output is rendered as a JSON array on the Processes tab.

For more information, refer to the docker top command reference.

Attach a console to the container output

  • In the Services tool window, right-click the container and then click Attach.

    The console is attached to the output of the ENTRYPOINT process running inside a container, and is rendered on the Attached Console tab.

For more information, refer to the docker attach command reference.

Browse files in a container

You can browse and manage files only in a running container.

  1. In the Services tool window, right-click the container and then click Show Files.

  2. On the Files tab, expand the nodes of the container's file system, or type a path in the field above the tree.

    The Files tab showing the files in a running container

To go to the home directory of the container user, click The Home Directory button Home Directory. To show or hide hidden files, click The Show Hidden Files button Show Hidden Files. To reload the tree, click The Refresh button Refresh.

For the full list of actions on the Files tab, refer to Files tab.

Edit container files

  1. On the Files tab, double-click a file, or select it and click The Open in Editor button Open in Editor.

  2. Edit the file in the editor. DataGrip saves the changes directly to the file in the container.

Manage files and directories

  1. On the Files tab, select a file or directory.

  2. On the toolbar or in the context menu, click one of the following:

    • The Create Directory button Create Directory: create a directory inside the selected directory.

      To create nested directories, separate their names with a slash, for example, config/local.

    • The Rename button Rename (Shift+F6): rename the selected file or directory.

    • The Delete button Delete: delete the selected file or directory with all its contents.

These actions are available only for files and directories that the container user has permission to modify.

Copy files to a container

  1. In the Services tool window, right-click the container and click Show Files.

  2. Drag files or directories from the file manager of your operating system to a directory on the Files tab.

    If you drop them on a file, DataGrip copies them to the directory that contains this file.

The files are copied, not moved. If a file with the same name already exists in the target directory, DataGrip asks whether to overwrite it. If you click No, none of the dragged files are copied.

Copy files from a container

  1. In the Services tool window, right-click the container and click Show Files.

  2. On the Files tab, select files or directories and click The Download to Scratch button Download to Scratch.

DataGrip copies the selected items to the Docker Files directory under Scratches and Consoles (for more details, refer to Scratch files), into a subdirectory named after the container.

Bind mounts on SELinux

If the host machine uses SELinux, the security module might prevent processes running inside the container from accessing the mounted files and directories. To avoid this, label the mounted files and directories with the :z option. For more information, refer to Configure the SELinux label.

When running Docker containers, DataGrip can automatically add the :z flag to all volume bindings on the host machine except top-level directories, such as /bin.

Apply SELinux labels for bind mounts

  1. Press Ctrl+Alt+S to open settings and then select Advanced Settings | Docker.

  2. Select Apply :z mount option to almost any bind volume for SELinux systems..

    Binding for SELinux systems
04 November 2026
Docker imagesDocker run configurations