PyCharm 2021.2 Help

Configure an interpreter using Docker


PyCharm integration with Docker allows you to run your applications in the variously configured development environments deployed in Docker containers.


Make sure that the following prerequisites are met:

  • Docker is installed, as described on the page Docker Docs. You can install Docker on the various platforms, but here we'll use the Windows installation.

    Note that you might want to repeat this tutorial on different platforms; then use Docker installations for macOS and Linux (Ubuntu, other distributions-related instructions are available as well).

  • You have a stable Internet connection.

    Ensure that you have a stable Internet connection, so that PyCharm can download and run busybox:latest. Once you have successfully configured Docker, you can go offline.

  • Before you start working with Docker, make sure that the Docker plugin is enabled. The plugin is bundled with PyCharm and is activated by default. If the plugin is not activated, enable it on the Plugins page of the IDE settings Ctrl+Alt+S as described in Manage plugins.

    In the Settings/Preferences dialog Ctrl+Alt+S, select Build, Execution, Deployment | Docker, and select Docker for <your operating system> under Connect to Docker daemon with. For example, if you're on macOS, select Docker for Mac. See more detail in Docker settings.

Note that you cannot install any Python packages into Docker-based project interpreters.

Preparing an example

Create a Python project QuadraticEquation, add the file, and copy and paste the following code:

import math class Solver: def demo(self, a, b, c): d = b ** 2 - 4 * a * c if d > 0: disc = math.sqrt(d) root1 = (-b + disc) / (2 * a) root2 = (-b - disc) / (2 * a) return root1, root2 elif d == 0: return -b / (2 * a) else: return "This equation has no roots" if __name__ == '__main__': solver = Solver() while True: a = int(input("a: ")) b = int(input("b: ")) c = int(input("c: ")) result = solver.demo(a, b, c) print(result)

Configuring Docker as a remote interpreter

Now, let's define a Docker-based remote interpreter.

Ensure that you have downloaded and installed Python on your computer.

Open the Add Python Interpreter dialog by either way:

  • When you're in the editor, the most convenient way is to use the Python Interpreter selector in the Overview of the user interface. Click the widget and select Add Interpreter ...

  • If you are in the Settings/Preferences dialog Ctrl+Alt+S, select Project <project name> | Python Interpreter. Click the The Configure project interpreter icon and select Add.

In the dialog that opens, select the Docker option, from the drop-down lists select the Docker server (if the server is missing, click New...), and specify the image name: python:latest.

Python interpreter path should have the default value:

Choose a docker

As a result, in the project settings, you should see something like this:

Set up an interpreter

Click OK to apply changes and close the dialog.

Running your application in a Docker container

In the gutter, next to the main clause, click the Run button, and choose Run '' command. You see that your script runs in the Docker container:

Run context menu

The script is launched in the Run tool window. As you can see, the prefix in the Run tool window shows the container ID.

Running the sample in a Docker container

Switch to the Services tool window to preview the container details. Expand the Containers node and you'll discover the one with the same ID.

Docker container in the Services tool window

You can switch to the Log tab to see the execution results.

Log tab in the Services tool window

Debugging your application in a Docker container

Next, let's debug the application. For that, let's put a breakpoint on the line that calculates d, click Run in the gutter and choose Debug 'Solver'.

Setting a breakpoint and launching the debugger

As you see in the Console tab of the Debug tool window, the debugger runs also in the Docker container:

Debugging in a Docker container

You can also discover it in the Services tool window. However, now this container has a different id, and hence - different name. You can switch to the Log tab to see the execution status.

Preview in the Services tool window


Let's summarize what has been done with the help of PyCharm:

  • We created a project and added a Python script.

  • We configured the remote interpreter.

  • We ran and debugged our script in the Docker containers.

  • Finally, we launched the Docker tool window and saw all the details visible in the Terminal.

Last modified: 02 August 2021