Installation and configuration manual

This section describes how to install and configure the nova-docker as a Nova Compute node.


To install a nova-docker compute node, you should have fully functional OpenStack infrastructure:

Supported OpenStack versions are Liberty and Mitaka.

The compute node should be installed and configured according to the Openstack installation manual referred previously, namely the nova compute and neutron services.

Install docker-engine and start the service. The installation and configuration instructions can be in Install Docker Engine.

Check that the docker service is running:

systemctl status docker

Additional or modified configuration for the nova-docker steps are explained in the sections below.

As nova needs to spawn docker containers, the nova user must be in the docker group; hence execute the command:

usermod -aG docker nova

We've noticed some problem during nova-docker plugin's start. If an error like this occurs

ImportError: No module named docker

please try to install the package python-docker and retry.


Indigo-DataCloud 1st release components are supported in Centos7 and Ubuntu 14.04.

The next sections detail installation instruction for each Operating System.

Installation on Ubuntu 14.04

The first step is to install the Indigo-DataCloud gpg keys and apt package repositories. Further details can be found here

All packages are signed with the INDIGO - DataCloud gpg key. Import the public key:

wget -q -O - | \
sudo apt-key add -

Install the apt repository:

dpkg -i indigodc-release_1.0.0-1_amd64.deb

Install the nova-docker package:

apt-get -y install python-nova-docker

Installation on Centos7

The first steps are the same as for Ubuntu 14.04, that is import the gpg key

rpm --import

Install the indigo1 repository for Centos7

yum -y install

Install the nova-docker package:

yum -y install python-nova-docker


Nova compute machine

Nova needs to be configured to use the Docker virt driver. Edit the configuration file /etc/nova/nova.conf according to the following options:

compute_driver = novadocker.virt.docker.DockerDriver

Create the directory /etc/nova/rootwrap.d, if it does not already exist, and inside that directory create a file "docker.filters" with the following content:

# nova-rootwrap command filters for setting up network in the docker driver
# This file should be owned by (and only-writeable by) the root user
# nova/virt/docker/ 'ln', '-sf', '/var/run/netns/.*'
ln: CommandFilter, /bin/ln, root

Restart the nova compute service

systemctl restart openstack-nova-compute

On OpenStack Newton, the openstack-nova-compute service might fail to start with an error like this:

ImportError: No module named novadocker.virt.docker

In this case it is necessary to manually create a link with the following command:

ln -s -t /usr/lib/python2.7/site-packages/nova/virt /usr/lib/python2.7/site-packages/novadocker

and restart the openstack-nova-compute service.

Glance service

In the machine where you are running the glance service, it needs to be configured to support the docker container format.

It's important to leave the default ones in order to not break an existing glance install.

container_formats = ami,ari,aki,bare,ovf,docker

Restart the glance services

systemctl restart openstack-glance-api openstack-glance-registry