Metadata-Version: 2.0
Name: lxdock
Version: 0.1.1
Summary: LXDock is a tool for orchestrating LXD containers.
Home-page: https://github.com/lxdock/lxdock
Author: Virgil Dupras, Morgan Aubert
Author-email: UNKNOWN
License: GPLv3
Keywords: lxd lxc containers environments orchestration devops
Platform: UNKNOWN
Classifier: Development Status :: 1 - Planning
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Requires-Dist: PyYAML (>=3.0,<4.0)
Requires-Dist: colorlog (>=2.0,<3.0)
Requires-Dist: pylxd (>=2.2,<3.0)
Requires-Dist: voluptuous (>=0.9,<1.0)

LXDock
######

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

.. contents:: Table of Contents
    :local:

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 http://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

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.


