Skip to content
This repository was archived by the owner on Sep 9, 2025. It is now read-only.
Veton Hajdari edited this page Apr 6, 2018 · 14 revisions

logo

A web UI for Linux containers based on LXD/LXC.

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

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, lui, here.

Screencast

Here's a screencast that demonstrates the use of the UI. -- Screencast

Installation Instructions

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.

Install

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 Setup

        cd lxdui

        python3 setup.py install

Start LXDUI

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:   lui start

When the app starts open a browser to the following link to access the app: http://127.0.0.1:15151

Clone this wiki locally