Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status

kitchen-lxd Kitchen Driver

A Test Kitchen Driver (and Transport) for Lxd.

Install & Usage Instructions


Build Status
Gem Version

A Test Kitchen Driver (with Transport) for Lxd.



Lxd version of 2.3 (the one where "lxc network" commands were introduced) or higher is required
for this driver which means that a native package must be installed on the system running Test

You do not have to prepare any container image specifically, like downloading it or installing ssh
server. The driver will download container image automatically from the provided remote server,
if it's not available locally. Also you can use lxd transport instead of default ssh. Which
means files will be uploaded to container using lxc file push command.

Installation and Setup

Install using command line:

gem install kitchen-lxd


Example config file may look like this:

  name: lxd
  binary: lxc # this is default
  remote: images # default
  network: lxdbr0 # default
  fix_chef_install: false # default
  fix_hostnamectl_bug: true # default

  name: lxd

Default values can be omitted, so the minimal config file looks like this:

  name: lxd

  name: lxd


Available options:

Name Description Type Default
binary Path to lxc executable. String lxc
remote Remote LXD server to download image from, if it does not exist locally. String images
network Network bridge to attach to container. String lxdbr0
wait_until_ready Wait for the network to come up. Boolean true
fix_chef_install Apply fix, to make available installation of Chef Omnibus package. Boolean false
fix_hostnamectl_bug Apply workaround to Ubuntu hostnamectl bug in LXD. Boolean true


Pull requests are very welcome! Make sure your patches are well tested.
Ideally create a topic branch for every separate change you make. For

  1. Fork the repo
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request


Created and maintained by Juri TimoŇ°in.


Apache 2.0 (see LICENSE)