Home
Learn more about Linux containers and LXD/LXC here: linuxcontainers.org
LXDUI leverages LXD's Python client library, pylxd (https://github.com/lxc/pylxd), for interacting with the LXD REST API. It allows for rapid provisioning and management of large number of containers from a web browser, and you can simultaneously create any number of containers, even from multiple images, in one step.
Version 2.0 of LXDUI is a complete rewrite of the application that better exposes LXD's feature set with additional functionality. A new CLI is now available for managing LXDUI as well. Learn more about the CLI here.
Here's a screencast that demonstrates the use of the UI. -- Screencast
As the name suggests, LXDUI is a visual interface for the LXD & LXC toolset. In order to use LXDUI you need to have LXD installed on your system. The following instructions walk you through the installation process so that you have a working system with LXD and LXDUI.
These instructions are targeted for an Ubuntu distribution, but you should be able to adapt the instructions to use in any distribution where LXD is supported.
Note: If you are on Ubuntu 16 or 18 you can use the following script that automates the whole installation process. To run the installer just copy the following command to your bash shell:
bash <(curl -fsSL https://gist.githubusercontent.com/vhajdari/f1a4bbfc30e1096ed285ffb2772f8f2f/raw/23d269cddc18373c4d3eb6b103cb3834b1c7d61c/lxdui-install.sh)
For Fedora users - instructions here
1. Install the Prerequisites - instructions here
2. Clone LXDUI from the GitHub repo:
git clone https://github.com/AdaptiveScale/lxdui.git
3. [Optional] Create a virtual environment for testing. Skip this step if you want to install it globaly on your system.
python3 -m venv mytestenv
Activate the virtual environment:
source mytestenv/bin/activate
4. Run the Installer (Setup)
You have a couple of options here. You can use pip or setuptools. Regardless of which way you chose to install it please make sure to upgrade pip first.
pip3 install --upgrade pip
To install with pip:
cd lxdui
pip3 install .
To install with setuptools:
cd lxdui
python3 setup.py install
At this point LXDUI should be installed and ready to start.
To start the app run: python3 run.py start
or use the new CLI: lxdui start
When the app starts open a browser to the following link to access the app: http://127.0.0.1:15151
Verion 2.0 introduced a new command line interface (CLI) for managing LXDUI.
Learn more about the CLI, lxdui, here.