Docker SDK for Python

A Python library for the Docker Engine API. It lets you do anything the

docker

Installation

The latest stable version is available on PyPI. Either add

docker

requirements.txt

pip install docker

If you are intending to connect to a docker host via TLS, add

docker[tls]

pip install docker[tls]

Usage

Connect to Docker using the default socket or the configuration in your environment:

import docker
client = docker.from_env()

You can run containers:

>>> client.containers.run("ubuntu:latest", "echo hello world")
'hello world\n'

You can run containers in the background:

>>> client.containers.run("bfirsh/reticulate-splines", detach=True)

You can manage containers:

>>> client.containers.list()
[, , ...]

>>> container = client.containers.get('45e6d2de7c54')
>>> container.attrs['Config']['Image']
"bfirsh/reticulate-splines"
>>> container.logs()
"Reticulating spline 1...\n"
>>> container.stop()

You can stream logs:

>>> for line in container.logs(stream=True):
...   print(line.strip())
Reticulating spline 2...
Reticulating spline 3...
...

You can manage images:

>>> client.images.pull('nginx')


>>> client.images.list()
[, , ...]

Read the full documentation to see everything you can do.