Prerequisites for the Amazon DCV server on Linux with Wayland
Amazon DCV enables clients to access a remote graphical session on a Linux server. This provides access to the corresponding Linux desktop. With Wayland, Amazon DCV supports virtual sessions only. For more information about virtual sessions, see Managing Amazon DCV sessions.
This topic describes how to install the prerequisites required to use Amazon DCV on a Linux server.
Contents
Install a desktop environment and desktop manager
Install a desktop environment and desktop manager to improve your experience with Amazon DCV on a Linux server.
A desktop environment is a graphical user interface (GUI) that helps you to interact with the Linux operating system. A desktop manager is a program that manages the user login screen, and starts and stops the desktop environment sessions.
With the Wayland display protocol, Amazon DCV works only with the GNOME desktop environment and the GDM desktop manager.
The following tabbed content shows the steps for installing the default desktop environment and desktop manager on the supported operating systems.
Ensure the graphical session is running
Ensure that your Linux server boots into a graphical session and that the display manager is running.
We recommend that you configure your Linux server to start the graphical session automatically when it boots.
To configure and start the graphical session on Linux:
Configure the graphical session to start automatically when the Linux server boots.
$sudo systemctl set-default graphical.targetStart the graphical session.
$sudo systemctl isolate graphical.targetVerify that the graphical session is running.
$sudo systemctl status graphical.targetThe graphical session is running if the command reports that
graphical.targetisactive.
Install the eglinfo utility
The eglinfo utility provides information about your Linux server's OpenGL configuration. The utility can be used to determine whether your Linux server is configured to support OpenGL hardware or software rendering. It provides information about the drivers and supported extensions.
Verify OpenGL software rendering
On non-GPU Linux servers, OpenGL is only supported in software rendering mode using the Mesa drivers. If you're using a non-GPU Linux server and intend to use OpenGL, ensure that the Mesa drivers are installed and properly configured on your Linux server.
This applies to non-GPU Linux servers only.
To verify that OpenGL software rendering is available
Use the following command:
$sudo eglinfo -p surfaceless | grep -i "opengl.*version"
The following shows example output if OpenGL software rendering is available:
OpenGL core profile version: 4.5 (Core Profile) Mesa 25.2.7 OpenGL core profile shading language version: 4.50 OpenGL compatibility profile version: 4.5 (Compatibility Profile) Mesa 25.2.7 OpenGL compatibility profile shading language version: 4.50 OpenGL ES profile version: OpenGL ES 3.2 Mesa 25.2.7 OpenGL ES profile shading language version: OpenGL ES GLSL ES 3.20
Install GPU drivers for graphics instances
Install and configure NVIDIA drivers
With Linux servers that have a dedicated NVIDIA GPU, ensure that the appropriate NVIDIA drivers are installed and properly configured. For instructions on how to install the NVIDIA drivers on an Amazon EC2 Linux instance, see Installing the NVIDIA Driver on Linux Servers in the Amazon EC2 User Guide.
-
This applies to Linux servers with NVIDIA GPUs only.
-
The GRID drivers support up to four 4K displays for each GPU installed. The gaming drivers support only one 4K display for each GPU installed.
To verify that your NVIDIA GPU supports hardware-based video encoding
Make sure that it supports NVENC encoding and that it has compute capabilities greater than or equal to 3.5.
To verify NVENC support, see the NVIDIA Video Encode and Decode GPU Support Matrix
If your NVIDIA GPU doesn't support NVENC encoding or if it doesn't have the required compute capabilities, software-based video encoding is used.
To verify that OpenGL hardware rendering is available
Use the following command:
$sudo eglinfo -p gbm | grep -i "opengl.*version"
The following shows example output if OpenGL hardware rendering is available.
OpenGL core profile version: 4.6.0 NVIDIA 595.91.07 OpenGL core profile shading language version: 4.60 NVIDIA OpenGL compatibility profile version: 4.6.0 NVIDIA 595.91.07 OpenGL compatibility profile shading language version: 4.60 NVIDIA OpenGL ES profile version: OpenGL ES 3.2 NVIDIA 595.91.07 OpenGL ES profile shading language version: OpenGL ES GLSL ES 3.20
Install and configure AMD drivers
An instance with an attached AMD GPU, such as a G4ad instance, must have the appropriate AMD driver installed. For instructions on how to install the AMD GPU drivers on a compatible Amazon EC2 instance, see Install AMD drivers on Linux instances.
For more information about Amazon EC2 G4ad instances, see the Deep dive on the
new Amazon EC2 G4ad instances