About GPU support

Anbox Cloud has support to manage GPUs and can provide them to individual containers for rendering and video encoding functionality.

In case that no GPU is available Anbox Cloud automatically falls back to software rendering and video encoding. This makes it possible to run entirely without a GPU.

Supported GPUs

Anbox Clouds allows access to GPUs from Intel, AMD and Nvidia inside the Anbox container. Concrete support for the individual GPU depends on the platform being using for Anbox. The included webrtc platform currently supports the following GPUs:

Vendor Model Render Hardware Video Encode
AMD WX5100, WX4100 Yes No
Nvidia Quadro, Tesla Yes Yes

For those GPUs which Anbox Cloud doesn’t support hardware video encoding, a software based video encoding fallback is available.

Enable Support for GPUs in Anbox Cloud

Anbox Cloud will automatically detect GPU devices on deployment and configure the cluster for these. You can’t mix GPUs from different vendors in a single deployment.

Required GPU slots

GPUs have limited capacity that can be shared amongst multiple containers. To fine-tune how many containers can run on a given node, configure the number of available GPU slots on the node.

See GPU slots for detailed information.

Using GPUs inside a Container

AMS configures a LXD container to pass through a GPU device from the host. As of right now all GPUs available to a machine are passed to every container owning a GPU slot. For Nvidia GPUs LXD uses the Nvidia container runtime to make the GPU driver of the host available to a container. When GPUs from Intel or AMD are being used no GPU driver is made available automatically. It has to be provided by an addon.

If a GPU driver is available inside the container there are no further differences of how to use it in comparison to a regular environment.

If you want to let an application use the GPU (even if you are not interested in streaming the visual output), launch it with the --enable-graphics flag. With this flag, the command will launch the container using the webrtc platform, which will automatically detect the underlying GPU and make use of it.

amc launch --enable-graphics my-application

Force Software Rendering and Video Encoding

Note: Software rendering and video encoding will utilise the CPU. This will mean you can run less containers on a system than you can, when you have a GPU.

It is possible to tell a container to run with software rendering. For that, simply change the instance type or resources of the application to not require a GPU. Anbox will then automatically determine that no GPU is available and use software rendering instead if a container is launched with graphics enabled.