Type: gpu

▶ Watch on YouTube

GPU device entries simply make the requested GPU device appear in the instance.

Note

Container devices may match multiple GPUs at once. However, for virtual machines a device can only match a single GPU.

GPUs available

The following GPUs can be specified using the gputype property:

• physical Passes through an entire GPU. This is the default if gputype is unspecified.

• mdev Creates and passes through a virtual GPU into the instance.

• mig Creates and passes through a MIG (Multi-Instance GPU) device into the instance.

• sriov Passes a virtual function of an SR-IOV enabled GPU into the instance.

gpu: physical

Supported instance types: container, VM

Passes through an entire GPU.

The following properties exist:

Key	Type	Default	Required	Description
vendorid	string	-	no	The vendor ID of the GPU device
productid	string	-	no	The product ID of the GPU device
id	string	-	no	The card ID of the GPU device
pci	string	-	no	The PCI address of the GPU device
uid	int	0	no	UID of the device owner in the instance (container only)
gid	int	0	no	GID of the device owner in the instance (container only)
mode	int	0660	no	Mode of the device in the instance (container only)

gpu: mdev

Supported instance types: VM

Creates and passes through a virtual GPU into the instance. A list of available mdev profiles can be found by running lxc info --resources.

The following properties exist:

Key	Type	Default	Required	Description
vendorid	string	-	no	The vendor ID of the GPU device
productid	string	-	no	The product ID of the GPU device
id	string	-	no	The card ID of the GPU device
pci	string	-	no	The PCI address of the GPU device
mdev	string	-	yes	The mdev profile to use (e.g. i915-GVTg_V5_4)

gpu: mig

Supported instance types: container

Creates and passes through a MIG compute instance. This currently requires NVIDIA MIG instances to be pre-created.

The following properties exist:

Key	Type	Default	Required	Description
vendorid	string	-	no	The vendor ID of the GPU device
productid	string	-	no	The product ID of the GPU device
id	string	-	no	The card ID of the GPU device
pci	string	-	no	The PCI address of the GPU device
mig.ci	int	-	no	Existing MIG compute instance ID
mig.gi	int	-	no	Existing MIG GPU instance ID
mig.uuid	string	-	no	Existing MIG device UUID (MIG- prefix can be omitted)

Note: Either mig.uuid (NVIDIA drivers 470+) or both mig.ci and mig.gi (old NVIDIA drivers) must be set.

gpu: sriov

Supported instance types: VM

Passes a virtual function of an SR-IOV enabled GPU into the instance.

The following properties exist:

Key	Type	Default	Required	Description
vendorid	string	-	no	The vendor ID of the parent GPU device
productid	string	-	no	The product ID of the parent GPU device
id	string	-	no	The card ID of the parent GPU device
pci	string	-	no	The PCI address of the parent GPU device