Docker Images for Intel® Distribution for Python*

By David A Liu, Published: 12/10/2016, Last Updated: 10/27/2017

We have published Docker images for Intel Python. The images can be found on Docker Hub and Google Cloud Platform Container Registry, and the Dockerfiles are also available on GitHub. We have images for Python 2 & Python 3, with both core and full configurations. Core contains NumPy/Scipy and dependences, and full contains everything that we distribute.  If you want to customize the Docker image, then you can start with the Dockerfiles that we publish or use the Docker FROM command to use our image as a base.

Getting started:

Docker is a popular Linux container technology that allows for deployment and repeatability of services and applications through a simple command line interface.  More information can be found at Docker’s official website,

Obtaining the Docker images for the distribution:

To see the images that are available, visit the Docker Hub link and use the docker pull command to obtain the desired distribution version and configuration.  

docker pull intelpython/intelpython3_full
docker pull intelpython/intelpython3_core
docker pull intelpython/intelpython2_full
docker pull intelpython/intelpython2_core

Using the Docker Images:

Several options exist for using these Docker images.  The native command when running the image gives the user a shell to operate the distribution with.  To use this, try the following command:

docker run -it intelpython/intelpython3_core

If the desire is to immediately use Python upon startup, use the following command:

docker run -it intelpython/intelpython3_core python

In order to utilize a Jupyter Notebook, use the following command:

docker run -p 8888:8888 intelpython/intelpython3_full jupyter notebook --ip='*' --port=8888 --allow-root --no-browser

The Jupyter Notebook can be opened by going to http://localhost:8888 in your browser, or http://<DOCKER-MACHINE-IP>:8888 if you are using a Docker Machine VM.

If you create a new environment within the container, one will need to install the kernel into IPython using the following information: Installing the IPython Kernel  

For tasks in which a volume needs to be mounted, please reference the Docker documentation on volume mounts.

Product and Performance Information


Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804