How to access the LXD web UI¶
Note
The LXD web UI is available as part of the LXD snap.
See the LXD-UI GitHub repository for the source code.
Graphical console of an instance in the LXD web UI¶
The LXD web UI provides you with a graphical interface to manage your LXD server and instances. It does not provide full functionality yet, but it is constantly evolving, already covering many of the features of the LXD command-line client.
Complete the following steps to access the LXD web UI:
Expose the server to the network¶
Make sure that your LXD server is exposed to the network.
You can expose the server during initialization, or afterwards by setting the core.https_address server configuration option.
Access the UI in your browser¶
Access the UI in your browser by entering the server address (for example, https://127.0.0.1:8443 for a local server, or an address like https://192.0.2.10:8443 for a server running on 192.0.2.10).
If you have already set up access to the UI, you will see the Instances page. For setup instructions, continue below.
Set up access¶
Access to the UI requires both a browser certificate and a trust token.
If you have not set up a secure TLS server certificate, LXD uses a self-signed certificate, which will cause a security warning in your browser. Use your browser’s mechanism to continue this time despite the security warning.
For example, in Chrome, click Advanced, then follow the link to Proceed at the bottom as shown below:
In Firefox, click Advanced, then follow the link to Accept the risk and continue.
Set up the browser certificate¶
Follow the instructions in the LXD UI browser page to install and select the browser certificate, also called a client certificate.
If you have previously installed a certificate for the LXD UI, your browser will offer you the option to use it. Confirm that the installed certificate’s issuer is listed is the LXD UI, then select it.
After you have selected your certificate, follow the LXD UI’s on-page instructions to set up the trust token.
Finally, click Connect in the UI to complete gaining access. You should then see the Instances page.
Now you can start creating instances, editing profiles, or configuring your server.
For detailed information about the authentication process, see: Remote API authentication.
Enable or disable the UI¶
The snap configuration option lxd ui.enable controls whether the UI is enabled for LXD.
Starting with LXD 5.21, the UI is enabled by default.
If you want to disable it, set the option to false:
sudo snap set lxd ui.enable=false
sudo systemctl reload snap.lxd.daemon
To enable it again, or to enable it for older LXD versions (that include the UI), set the option to true:
sudo snap set lxd ui.enable=true
sudo systemctl reload snap.lxd.daemon