LXConsole - Installation in an Incus Container

LXConsole is an open source application that provides a web-based user interface capable of managing multiple Incus and LXD servers from a single location.

Incus Documentation

Prerequisite: Incus - Ubuntu 26.04 Installation

Create Container (Ubuntu 26.04)

incus launch images:ubuntu/26.04 lxconsole --profile=default --profile=bridgeprofile -c security.nesting=true -c boot.autostart=true

Setup for LXConsole (Docker)

Shell into the created container:

incus shell lxconsole

Setup User and SSH Access:

adduser <username>
usermod -aG sudo <username>
apt update && apt install wget curl git nano openssh-server dnsutils openvswitch-switch -y

Setup Static Server IP:

nano /etc/netplan/10-lxc.yaml

network:
  version: 2
  ethernets:
    eth0:
      addresses:
      - "192.168.x.x/24"
      nameservers:
        addresses:
        - 192.168.x.x
        search:
        - pengwin.home
      routes:
      - to: "default"
        via: "192.168.x.x"

Apply the configuration:

netplan apply

Exit from the container:

exit

Use Incus List to see the IP of the lxconsole container

user@incus:~$ incus list
+----------------+---------+----------------------+--------------+-----------------+-----------+
|      NAME      |  STATE  |         IPV4         |     IPV6     |      TYPE       | SNAPSHOTS |
+----------------+---------+----------------------+--------------+-----------------+-----------+
| lxconsole      | RUNNING | 192.168.x.x (eth0)   |              | CONTAINER       | 0         |
+----------------+---------+----------------------+--------------+-----------------+-----------+

SSH into the container:

ssh <username>@<lan ip of container>

Install Docker

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker [YourUser]
newgrp docker

Note: If you are on Ubuntu 26.04, the newgrp command is not installed by default. You need to install the util-linux-extra package:

sudo apt install util-linux-extra

Create Container for LXConsole

Become root:

sudo -i

Create directories for LXConsole container (this is my preferred place to put containers):

mkdir -p /opt/stacks/lxconsole
mkdir -p /opt/stacks/lxconsole/lxbackups

Change directory to LXConsole and create compose file:

cd /opt/stacks/lxconsole

nano compose.yaml

services:
  lxconsole:
    image: penninglabs/lxconsole:latest
    container_name: lxconsole
    restart: unless-stopped
    ports:
      - '5000:5000'
    volumes:
      - /mnt/incus:/opt/stacks/lxconsole/backups
      - /opt/stacks/lxconsole/certs:/opt/lxconsole/certs
      - /opt/stacks/lxconsole/server:/opt/lxconsole/instance

Start the LXConsole container:

docker compose up -d

Access the LXConsole

http://192.168.x.x:5000

Create a user

Login

Add a Server to LXConsole:

On the Incus server:

nano lxconsole.crt

Now in the lxconsole web ui, click on the ‘Add Server’ button in the upper right of the window. You’ll be prompted with a modal (pop-up) window. In that window above the fields, you’ll see a bit of information. There is a link on that information you need to click. Follow the instructions (create the crt and run the two incus commands. Then add the server in the pop-up using the relevant information.