Type: pci

▶ Watch on YouTube (opens in a new tab)

Note
The pci device type is supported for VMs. It does not support hotplugging.

PCI devices are used to pass raw PCI devices from the host into a virtual machine.

They are mainly intended to be used for specialized single-function PCI cards like sound cards or video capture cards. In theory, you can also use them for more advanced PCI devices like GPUs or network cards, but it's usually more convenient to use the specific device types that LXD provides for these devices (gpu device or nic device).

Device options

pci devices have the following device options:

address

PCI address of the device

Key:
address

Type:
string

Required:
yes

Configuration examples

Add a pci device to a virtual machine by specifying its PCI address:

lxc config device add <instance_name> <device_name> pci address=<pci_address>

To determine the PCI address, you can use lspci, for example.

See Configure devices for more information.