=========
LXC Usage
=========

Basic Usage
===========

Create a new container
----------------------

.. code-block:: bash

   lxc-create -n CONTAINER -t debian

.. Note:: always use FQDN as container name since by default the capability to set hostname is dropped.

Start an existing container (in foreground)
-------------------------------------------

.. code-block:: bash

   lxc-start -n CONTAINER

Start an existing container (in background)
-------------------------------------------

.. code-block:: bash

   lxc-start -n CONTAINER -d

Attach console to in background started container
-------------------------------------------------

.. code-block:: bash

   lxc-console -n CONTAINER

Shutdown an existing container
------------------------------

.. code-block:: bash

   lxc-stop -n CONTAINER

Kill an existing container
--------------------------

.. code-block:: bash

   lxc-kill -n CONTAINER

or

.. code-block:: bash

   lxc-stop -n CONTAINER -k

Delete an existing container
----------------------------

.. code-block:: bash

   lxc-destroy -n CONTAINER

List existing containers on the system
--------------------------------------

.. code-block:: bash

   lxc-list

and

.. code-block:: bash

   lxc-ls --fancy