---
title: "Introducing pylxd\n    | Ubuntu"
description: In part of my work for nova-compute-lxd, we use a combination of httplib,
  UNIX domain sockets, and JSON to talk to the LXD daemon via the REST API. Talking
  to various people involved in the LXD project, I have decided to split this part
  of nova-compute-lxd into its own project called pylxd. Pylxd is a  […]
url: https://ubuntu.com/blog/introducing-pylxd?format=md
keywords: index, follow
---

1. [Blog](https://ubuntu.com/blog)
2. Article

---

[Canonical](https://ubuntu.com/blog/author/canonical "More about Canonical")

27 May 2015

# Introducing pylxd

[containers](https://ubuntu.com/blog/tag/containers)
[docker](https://ubuntu.com/blog/tag/docker)
[LXC](https://ubuntu.com/blog/tag/lxc)
[LXD](https://ubuntu.com/blog/tag/lxd)
[OpenStack](https://ubuntu.com/blog/tag/openstack)
[Ubuntu](https://ubuntu.com/blog/tag/ubuntu)

---

Share the article

In part of my work for nova-compute-lxd, we use a combination of httplib, UNIX domain sockets, and JSON to talk to the LXD daemon via the REST API. Talking to various people involved in the LXD project, I have decided to split this part of nova-compute-lxd into its own project called pylxd. Pylxd is a general python library that you can use to interact with LXD in order to do container operations.

Right now, it is about 80% complete, the bits that are missing is that it needs more unit tests and needs more container operations (snapshots, running commands in the container, etc). That functionality will be coming in later releases of pylxd. I intend to use pylxd in the next version of nova-compute-lxd for the Liberty release of OpenStack as well. I am sure that there is other use cases that developers and users can use pylxd for.

To use pylxd, you just have to clone the git tree and build it. An example usage of pylxd is that you need a way to display the ‘/etc/hosts’ from your running ‘test1′ container. With pylxd this is pretty simple to do:

`#!/usr/bin/python`

from pylxd import api
c = api.API()
print c.get\_container\_file(‘test1′, ‘/etc/hosts’)

The result of the above snippet is that the ‘/etc/hosts’ from the ‘test1′ container will be displayed. Pretty simple eh?

The code for pylxd is [available on github](https://github.com/lxc/pylxd). Please report give it a twirl, please report bugs, and would love to get feedback.

### About the author

Chuck Short is a software engineer at Canonical. Originally from Vancouver but based in Ottawa, Chuck’s mission is to make sure OpenStack is a first class experience for both the X86 world and ARM world. You can follow his blog at [zulcss.wordpress.com](https://zulcss.wordpress.com/)

## Newsletter signup

Get the latest Ubuntu news and updates in your inbox.

Work email:

\*I agree to receive information about Canonical's
products and services.

By submitting this form, I confirm that I have read and agree to [Canonical's Privacy Policy](https://canonical.com/legal/data-privacy).

Sign up

## Share on

---

## Related posts

[### Surviving the uncharted: when dedicated OpenStack expertise is your best ally in disaster recovery](https://ubuntu.com/blog/support-restores-openstack)

A customer’s OpenStack control plane went down overnight after their only backup proved stale. Canonical support rebuilt the database cluster live, service by service, without...

[Lidia Luna Puerta](https://ubuntu.com/blog/author/lidia-luna)

1 September 2026

[### Arduino® VENTUNO™ Q is available for pre-order with Ubuntu pre-installed](https://ubuntu.com/blog/arduino-ventuno-q-is-available-for-pre-order-with-ubuntu-pre-installed)

London, UK – August 25, 2026 – Following our initial collaboration announcement in March 2026, Canonical and Arduino (a subsidiary of Qualcomm Technologies, Inc.) are excited...

[Canonical](https://ubuntu.com/blog/author/canonical)

25 August 2026

[### Ubuntu Server: a platform made for enterprise scale](https://ubuntu.com/blog/ubuntu-server-a-platform-made-for-enterprise-scale)

A platform is an environment that allows software to run smoothly across the infrastructure, runtime, and application layers. The key word there is “smoothly”: a good platform...

[Rhys Knipe](https://ubuntu.com/blog/author/rhysknipe)

7 July 2026

[### Canonical becomes Gold Sponsor of Trifecta Tech Foundation](https://ubuntu.com/blog/canonical-becomes-gold-sponsor-of-trifecta-tech-foundation)

Canonical is pleased to announce it is now a Gold Sponsor of the Trifecta Tech Foundation, a non-profit that creates open source building blocks for critical infrastructure...

[Canonical](https://ubuntu.com/blog/author/canonical)

30 June 2026
