Introduction to nova-compute-lxd

LXD is a lightweight container hypervisor for full system containers, unlike Docker and Rocket which is for application containers. This means that the container will look and feel like a regular VM – but will act like a container. LXD uses the same container technology found in the Linux kernel (cgroups, namespaces, LSM, etc). The LXD project has a 2 week development cycle which many more features are coming in the future. Stéphane Graber’s blog post is a very good introduction about LXD.

I have been focusing on LXD with OpenStack integration. In order to facilitate the OpenStack integration with LXD we have created a plugin called nova-compute-lxd (nclxd). The plugin uses the REST API to interact with OpenStack to provide common container operations to OpenStack.  An high level example of how nclxd creates a container is the following:

  1. Download the tarball image from glance.
  2. Untar the tarball image into its own directory.
  3. Create a rootfs of the tarball that have been just created.
  4. Craft the appropriate json needed by the LXD rest api
  5. Tell the LXD daemon to create a container by generating a “put” request.

There is a couple of ways where one can install nclxd and use it with OpenStack:

Installing the plugin from source

The source for nclxd is available via Github. To install the source

git clone

After you have installed the source and configured LXD. You will need to configure the compute driver in your /etc/nova/nova.conf to the following:


and configure LXD, configure OpenStack, and restart the nova-compute service.

Installing from the Ubuntu Archive

Since nclxd is still configured to be a technology preview, it is not available via the Ubuntu Cloud Archive. However it is available for Ubuntu 15.04. To install it simply run the following command:

sudo apt-get install nova-compute-lxd

Once you have finished installing you will need to configure LXD, configure your nova user to see the LXD daemon and restart your nova-compute service.

Installing via Juju Charms

Installing nclxd via the nova-compute charm is the easiest way to deploy it. In order for you to use nclxd with the charm, the option is simply the following in the nova-compute charm:

virt-type: lxd

Once you have deployed the nova-compute charm with LXD enable, the users with be created with the correct permissions, and nova-compute will just be simply ready for you to use.

Using LXD with Openstack

Once you have finished downloading and configured nclxd you will need to upload an cloud image to the glance server that LXD can use. In order to do that you simply have to do the following:

wget -O vivid-server-cloudimg-amd64-root.tar.gz \ vivid-server-cloudimg-amd64-root.tar.gz
glance image-create --name='lxc' --container-format=bare --disk-format=raw \
< vivid-server-cloudimage-amd64-root.tar.gz

After you upload the image to glance then you will be ready to go. If you have any questions please don’t hesitate to ask on the LXC mailing, #lxcontainers IRC channel on freenode, or contacting me directly. We always love getting bug reports and feedback!


May 1, 2015. Uncategorized.

One Comment

  1. Siddharth Deshpande replied:

    quoting from Stephane Graber’s reply to a comment on his blog post:

    Stéphane Graber says:
    2015/04/22 at 9:05 AM

    Networking can now be configured either directly for a container or for a set of containers through the use of profiles.

    CPU and memory quotas will soon be implemented through the limits.* configuration keys. Until then, you can use the raw.lxc configuration key to pass LXC config snippets (lxc.cgroup.memory.* for example).

    Being able to set CPU/memory etc. restrictions on containers is an essential feature for multi-tenant environments. Any ETA on when this functionality will be available with this plugin, so that these parameters can be directly passed to openstack at container creation time?

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

Trackback URI

%d bloggers like this: