# LXD

> This is the documentation for LXD, a system container and virtual machine manager.


2014-2026 AGPL-3.0, LXD contributors

## Pages in this subsection

- [How-to guides](https://canonical.com/lxd/docs/default/howto/index.html.md): These how-to guides cover key operations and processes in LXD.
- [How to initialize LXD](https://canonical.com/lxd/docs/default/howto/initialize/index.html.md): Before you can create a LXD instance, you must configure and initialize LXD.
- [How to access the LXD web UI](https://canonical.com/lxd/docs/default/howto/access_ui/index.html.md): The LXD web UI is available as part of the LXD snap.
- [How to access the local LXD documentation](https://canonical.com/lxd/docs/default/howto/access_documentation/index.html.md): The latest version of the LXD documentation is available at `documentation.ubuntu.com/lxd`.
- [How to expose LXD to the network](https://canonical.com/lxd/docs/default/howto/server_expose/index.html.md): By default, LXD can be used only by local users through a Unix socket and is not accessible over the...
- [How to configure the LXD server](https://canonical.com/lxd/docs/default/howto/server_configure/index.html.md): See Server configuration for all configuration options that are available for the LXD server.
- [How to configure Auth0 as login method for the LXD UI and CLI](https://canonical.com/lxd/docs/default/howto/oidc_auth0/index.html.md): Auth0 is a flexible, drop-in solution to add authentication and authorization services to your appli...
- [How to configure Ory Hydra as login method for the LXD UI](https://canonical.com/lxd/docs/default/howto/oidc_ory/index.html.md): Ory Hydra is an easy solution to authenticate users for the LXD UI. It supports local users and soci...
- [How to configure Keycloak as login method for LXD](https://canonical.com/lxd/docs/default/howto/oidc_keycloak/index.html.md): Keycloak is a self-hosted open source tool for authentication. Keycloak supports OIDC and can be use...
- [How to configure authentication with Entra ID](https://canonical.com/lxd/docs/default/howto/oidc_entra_id/index.html.md): Configure LXD to authenticate using Entra ID via OpenID Connect (OIDC) in your tenant.
- [How to add command aliases](https://canonical.com/lxd/docs/default/howto/lxc_alias/index.html.md): Command aliases are a concept in the LXD CLI.
- [How to create instances](https://canonical.com/lxd/docs/default/howto/instances_create/index.html.md): When creating an instance, you must specify the image on which the instance should be based.
- [How to configure instances](https://canonical.com/lxd/docs/default/howto/instances_configure/index.html.md): You can configure instances by setting Instance properties, Instance options, or by adding and confi...
- [How to manage instances](https://canonical.com/lxd/docs/default/howto/instances_manage/index.html.md): When listing the existing instances, you can see their type, status, and location (if applicable).
- [How to troubleshoot failing instances](https://canonical.com/lxd/docs/default/howto/instances_troubleshoot/index.html.md): If your instance fails to start and ends up in an error state, this usually indicates a bigger issue...
- [How to configure Ubuntu Pro guest attachment](https://canonical.com/lxd/docs/default/howto/instances_ubuntu_pro_attach/index.html.md): If Ubuntu Pro is enabled on a LXD host, guest instances can be automatically attached to the Pro sub...
- [How to access files in an instance](https://canonical.com/lxd/docs/default/howto/instances_access_files/index.html.md): You can manage files inside an instance using the LXD client or the API without needing to access th...
- [How to access the console](https://canonical.com/lxd/docs/default/howto/instances_console/index.html.md): You can access the instance console to log in to the instance and see log messages.
- [How to add a routed NIC device to a virtual machine](https://canonical.com/lxd/docs/default/howto/instances_routed_nic_vm/index.html.md): When adding a routed NIC device to an instance, you must configure the instance to use the link-loca...
- [How to back up instances](https://canonical.com/lxd/docs/default/howto/instances_backup/index.html.md): There are different ways of backing up your instances:
- [How to migrate LXD instances between servers](https://canonical.com/lxd/docs/default/howto/instances_migrate/index.html.md): If you use the LXD client, you can migrate or copy instances from one LXD server (remote or local) t...
- [How to import physical or virtual machines to LXD instances](https://canonical.com/lxd/docs/default/howto/import_machines_to_instances/index.html.md): <p class="youtube_link">
- [How to pass an NVIDIA GPU to a container](https://canonical.com/lxd/docs/default/howto/container_gpu_passthrough_with_docker/index.html.md): If you have an NVIDIA GPU (either discrete (dGPU) or integrated (iGPU)) and you want to pass the run...
- [How to use remote images](https://canonical.com/lxd/docs/default/howto/images_remote/index.html.md): The `lxc` CLI command is pre-configured with several remote image servers.
- [How to manage images](https://canonical.com/lxd/docs/default/howto/images_manage/index.html.md): When working with images, you can inspect various information about the available images, view and e...
- [How to associate profiles with an image](https://canonical.com/lxd/docs/default/howto/images_profiles/index.html.md): You can associate one or more profiles with a specific image.
- [How to copy and import images](https://canonical.com/lxd/docs/default/howto/images_copy/index.html.md): To add images to an image store, you can either copy them from another server or import them from fi...
- [How to create images](https://canonical.com/lxd/docs/default/howto/images_create/index.html.md): If you want to create and share your own images, you can do this either based on an existing instanc...
- [How to create and configure projects](https://canonical.com/lxd/docs/default/howto/projects_create/index.html.md): You can configure projects at creation time or later.
- [How to work with different projects](https://canonical.com/lxd/docs/default/howto/projects_work/index.html.md): If you have more projects than just the `default` project, you must make sure to use or address the ...
- [How to confine users to specific projects](https://canonical.com/lxd/docs/default/howto/projects_confine/index.html.md): You restrict users or clients to specific projects.
- [How to manage storage pools](https://canonical.com/lxd/docs/default/howto/storage_pools/index.html.md): See the following sections for instructions on how to create, configure, view and resize Storage poo...
- [How to manage storage volumes](https://canonical.com/lxd/docs/default/howto/storage_volumes/index.html.md): <p class="youtube_link">
- [How to manage storage buckets](https://canonical.com/lxd/docs/default/howto/storage_buckets/index.html.md): Storage buckets let you store and manage object-based data using either local or distributed storage...
- [How to create an instance in a specific storage pool](https://canonical.com/lxd/docs/default/howto/storage_create_instance/index.html.md): Instance storage volumes are created in the storage pool that is specified by the instance’s root di...
- [How to back up custom storage volumes](https://canonical.com/lxd/docs/default/howto/storage_backup_volume/index.html.md): There are different ways of backing up your custom storage volumes:
- [How to move or copy storage volumes](https://canonical.com/lxd/docs/default/howto/storage_move_volume/index.html.md): You can copy or move custom storage volumes from one storage pool to another, or copy or rename them...
- [How to create a network](https://canonical.com/lxd/docs/default/howto/network_create/index.html.md): To create a managed network, use the `lxc network` command and its subcommands.
- [How to configure a network](https://canonical.com/lxd/docs/default/howto/network_configure/index.html.md): To configure an existing network, use either the `lxc network set` and `lxc network unset` commands ...
- [How to configure LXD as a BGP server](https://canonical.com/lxd/docs/default/howto/network_bgp/index.html.md): The BGP server feature is available for the Bridge network and the Physical network.
- [How to configure network ACLs](https://canonical.com/lxd/docs/default/howto/network_acls/index.html.md): Network ACLs are available for the OVN NIC type, the OVN network and the Bridge network (with some e...
- [How to configure network forwards](https://canonical.com/lxd/docs/default/howto/network_forwards/index.html.md): Network forwards are available for the OVN network and the Bridge network.
- [How to configure network zones](https://canonical.com/lxd/docs/default/howto/network_zones/index.html.md): Network zones are available for the OVN network and the Bridge network.
- [How to configure your firewall](https://canonical.com/lxd/docs/default/howto/network_bridge_firewalld/index.html.md): This guide applies to managed bridge networks only.
- [How to integrate with `systemd-resolved`](https://canonical.com/lxd/docs/default/howto/network_bridge_resolved/index.html.md): This guide applies to managed bridge networks only.
- [How to set up OVN with LXD](https://canonical.com/lxd/docs/default/howto/network_ovn_setup/index.html.md): See the following sections for how to set up a basic OVN network, either as a standalone network or ...
- [How to configure network load balancers](https://canonical.com/lxd/docs/default/howto/network_load_balancers/index.html.md): Network load balancers are currently available for the OVN network.
- [How to create OVN peer routing relationships](https://canonical.com/lxd/docs/default/howto/network_ovn_peers/index.html.md): This guide applies to OVN networks only.
- [How to display IPAM information of a LXD deployment](https://canonical.com/lxd/docs/default/howto/network_ipam/index.html.md): is a method used to plan, track, and manage the information associated with a computer network’s IP ...
- [How to form a cluster](https://canonical.com/lxd/docs/default/howto/cluster_form/index.html.md): When forming a LXD cluster, you start with a bootstrap server.
- [How to manage a cluster](https://canonical.com/lxd/docs/default/howto/cluster_manage/index.html.md): After your cluster is formed, use `lxc cluster list` to see a list of its members and their status. ...
- [How to configure networks for a cluster](https://canonical.com/lxd/docs/default/howto/cluster_config_networks/index.html.md): All members of a cluster must have identical networks defined.
- [How to configure storage for a cluster](https://canonical.com/lxd/docs/default/howto/cluster_config_storage/index.html.md): All members of a cluster must have identical storage pools.
- [How to manage instances in a cluster](https://canonical.com/lxd/docs/default/howto/cluster_manage_instance/index.html.md): In a cluster setup, each instance lives on one of the cluster members.
- [How to set up cluster groups](https://canonical.com/lxd/docs/default/howto/cluster_groups/index.html.md): <p class="youtube_link">
- [How to recover a cluster](https://canonical.com/lxd/docs/default/howto/cluster_recover/index.html.md): It might happen that one or several members of your cluster go offline or become unreachable.
- [How to set up a highly available virtual IP for clusters](https://canonical.com/lxd/docs/default/howto/cluster_vip/index.html.md): This page describes how to enhance the high availability (HA) of the control plane for a LXD cluster...
- [How to benchmark performance](https://canonical.com/lxd/docs/default/howto/benchmark_performance/index.html.md): <p class="youtube_link">
- [How to increase the network bandwidth](https://canonical.com/lxd/docs/default/howto/network_increase_bandwidth/index.html.md): You can increase the network bandwidth of your LXD setup by configuring the transmit queue length (`...
- [How to send logs to Loki](https://canonical.com/lxd/docs/default/howto/logs_loki/index.html.md): LXD publishes information about its activity in the form of events. The `lxc monitor` command allows...
- [Set up a Grafana dashboard](https://canonical.com/lxd/docs/default/howto/grafana/index.html.md): To visualize the metrics and logs data, set up Grafana.
- [How to recover instances in case of disaster](https://canonical.com/lxd/docs/default/howto/disaster_recovery/index.html.md): <p class="youtube_link">
- [How to perform disaster recovery with storage replication](https://canonical.com/lxd/docs/default/howto/disaster_recovery_replication/index.html.md): To enable disaster recovery, set up a secondary LXD deployment in a different location that can take...
- [How to securely decommission a LXD deployment](https://canonical.com/lxd/docs/default/howto/decommission/index.html.md): How to securely decommission a LXD server, cluster member, or cluster.
- [How to manage the LXD snap](https://canonical.com/lxd/docs/default/howto/snap/index.html.md): The recommended way to manage LXD is its snap package.
- [How to harden security for LXD](https://canonical.com/lxd/docs/default/howto/security_harden/index.html.md): To increase the security posture of your LXD deployment, review the following hardening recommendati...
- [Troubleshooting](https://canonical.com/lxd/docs/default/howto/troubleshoot/index.html.md): If you run into problems when using LXD, check the following how-to guides to see if they help resol...
- [How to troubleshoot (some) Dqlite errors](https://canonical.com/lxd/docs/default/howto/dqlite_troubleshoot/index.html.md): Dqlite is the distributed database that LXD uses to store information

## Optional

- [Top-level llms.txt](https://canonical.com/lxd/docs/default/llms.txt): Complete documentation index.