lxdock

Build and orchestrate your development environments with LXD - a.k.a. Vagrant is Too Heavy™

Showing:

Popularity

Downloads/wk

0

GitHub Stars

351

Maintenance

Last Commit

2yrs ago

Contributors

18

Package

Dependencies

0

License

GPLv3

Categories

Readme

LXDock

.. image:: https://readthedocs.org/projects/lxdock/badge/?style=flat-square&version=stable :target: https://lxdock.readthedocs.io/en/stable/ :alt: Documentation

.. image:: https://img.shields.io/pypi/l/lxdock.svg?style=flat-square :target: https://pypi.python.org/pypi/lxdock/ :alt: License

.. image:: https://img.shields.io/pypi/v/lxdock.svg?style=flat-square :target: https://pypi.python.org/pypi/lxdock/ :alt: Latest Version

.. image:: https://img.shields.io/travis/lxdock/lxdock.svg?style=flat-square :target: https://travis-ci.org/lxdock/lxdock :alt: Build status

.. image:: https://img.shields.io/codecov/c/github/lxdock/lxdock.svg?style=flat-square :target: https://codecov.io/github/lxdock/lxdock :alt: Codecov status

|

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

.. contents:: Table of Contents :local:

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 <https://github.com/lxdock/lxdock/issues/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.

.. _LXD: https://www.ubuntu.com/cloud/lxd .. _requirements: https://lxdock.readthedocs.io/en/stable/getting_started.html#requirements

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 <https://github.com/robvdl>), Norman Kabir (@nkabir <https://github.com/nkabir>)

Original Authors

Virgil Dupras (@hsoft <https://github.com/hsoft>), Morgan Aubert (@ellmetha <https://github.com/ellmetha>) and contributors_.

.. _contributors: https://github.com/lxdock/lxdock/contributors

License

GPLv3. See LICENSE for more details.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial