Build and orchestrate your development environments with LXD - a.k.a. Vagrant is Too Heavy™
Clone or download
robvdl Merge pull request #155 from lxdock/robvdl/lxd-bridge-fix
Fix Travis CI tests, lxd init already sets up a bridge now
Latest commit deaf7ce Jul 13, 2018
Permalink
Failed to load latest commit information.
.github Added pull request template Mar 8, 2017
contrib/completion Fix shell -c command is now like Vagrant Mar 15, 2018
docs Updating docs for 0.5 release part 1 (#137) Mar 21, 2018
lxdock Expanduser for shares as well as additional share properties. (#145) May 29, 2018
scripts Fix Travis CI tests, lxd init already sets up a bridge now Jun 26, 2018
tests Expanduser for shares as well as additional share properties. (#145) May 29, 2018
.codecov.yml Make codecov relax (#91) Jun 23, 2017
.editorconfig Add editorconfig file Nov 8, 2016
.gitignore Local Vagrant test setup and Travis using the same ci setup scripts (#… Mar 11, 2018
.travis.yml Tidyup .travis.yml (#126) Mar 12, 2018
CHANGELOG.rst Added changelog file Apr 3, 2017
CONTRIBUTING.rst Added a CONTRIBUTING file Apr 2, 2017
LICENSE Add GPLv3 license Sep 18, 2016
MANIFEST.in Prepared 0.1.0 release Mar 9, 2017
Makefile Added clean command to Makefile (#138) Mar 21, 2018
README.rst Fix grammar Mar 12, 2018
Vagrantfile Local Vagrant test setup and Travis using the same ci setup scripts (#… Mar 11, 2018
requirements-dev.txt Avoid installing Sphinx during Travis tests (fixes recursion issue) (#… Mar 12, 2018
requirements-tests.txt Pin ansible < 2.5 to keep supporting Python 3.4 (#151) May 30, 2018
setup.cfg Updated isort config and impacted files Jun 1, 2017
setup.py Make sure we don't install pylxd 2.2.7 Jul 13, 2018
tox.ini ansible: add lxd_transport option (#94) Jul 16, 2017

README.rst

LXDock

Documentation License Latest Version Build status Codecov status

LXDock is a wrapper around LXD that allows developers to orchestrate their development environments using a workflow similar to Vagrant.

Status: New Maintainers

As of LXDock v0.4.1 the two creators of LXDock stopped using it, however the project has several new maintainers now.

See: issue #106

The Travis CI tests are working again as we have switched to the Snap version of LXD since the PPA is no longer maintained. This is great news as it has allowed a number of outstanding PR's to be merged, with more to come.

There is also a Vagrantfile included for running the tests locally.

The next release will be v0.5.0, but no release date has been set at this point.

More to come...

Why use LXDock?

It's fast. LXDock is much much faster than a typical Vagrant + Virtualbox setup.

Multi-arch. Vagrant has been designed with Virtualbox and x86 in mind. Even if you use alternative providers, you're going to have to jump through inelegant hoops to have your Vagrantfile work on x86 and arm (for example) at the same time because the very concept of a Vagrant box is arch-specific.

Simpler. When working with containers, much of the complexity of Vagrant becomes useless. Why the need for special "vagrant-prepared" boxes when lxc exec is available? It's much simpler to use whatever images are provided directly by lxd. By removing the need to manage boxes, lxdock suddenly becomes much simpler (a simple wrapper around lxd, really).

Documentation

Online browsable documentation is available at https://lxdock.readthedocs.io.

Head over to the documentation for all the details on how to set up LXDock and how to start using containers in your project!

Requirements

LXD, Python 3.4+. Please refer to the requirements section of the documentation for a full list of dependencies.

Communication

You can join the #lxdock channel on irc.freenode.net to get help and ask questions related to the development of LXDock.

Current Maintainers

Rob van der Linde (@robvdl), Norman Kabir (@nkabir)

Original Authors

Virgil Dupras (@hsoft), Morgan Aubert (@ellmetha) and contributors.

License

GPLv3. See LICENSE for more details.