View a markdown version of this page

Prerequisites for the Amazon DCV server on Linux with Wayland - Amazon DCV
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

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.

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.

Note

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.

Amazon Linux 2027

The default desktop environment for Amazon Linux 2027 is GNOME and the default desktop manager is GDM.

To install and configure the desktop environment and desktop manager on Amazon Linux 2027
  1. Install the desktop environment and the desktop manager packages.

    $ sudo dnf group install "Desktop"
  2. Update the software packages to ensure that the Linux server is up to date.

    $ sudo dnf upgrade
  3. Reboot the Linux server.

    $ sudo reboot
RHEL, CentOS, and Rocky Linux 10

The default desktop environment for RHEL, CentOS, and Rocky Linux 10 is GNOME and the default desktop manager is GDM.

To install and configure the desktop environment and desktop manager on RHEL, CentOS, and Rocky Linux
  1. Install the desktop environment and the desktop manager packages.

    $ sudo dnf group install "Server with GUI"
  2. Update the software packages to ensure that the Linux server is up to date.

    $ sudo dnf upgrade
  3. Reboot the Linux server.

    $ sudo reboot
Ubuntu 26.04

The default desktop environment for Ubuntu 26.04 is GNOME and the default desktop manager is GDM.

To install and configure the desktop environment and desktop manager on Ubuntu 26.04
  1. Install the desktop environment and the desktop manager packages.

    $ sudo apt update
    $ sudo apt install ubuntu-desktop
  2. Update the software packages to ensure that the Linux server is up to date.

    $ sudo apt upgrade
  3. Reboot the Linux server.

    $ sudo reboot

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:

  1. Configure the graphical session to start automatically when the Linux server boots.

    $ sudo systemctl set-default graphical.target
  2. Start the graphical session.

    $ sudo systemctl isolate graphical.target
  3. Verify that the graphical session is running.

    $ sudo systemctl status graphical.target

    The graphical session is running if the command reports that graphical.target is active.

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.

Amazon Linux 2027
To install the eglinfo utility

Run the following command:

$ sudo dnf install egl-utils
RHEL, CentOS, and Rocky Linux 10
To install the eglinfo utility

Run the following command:

$ sudo dnf install egl-utils
Ubuntu 26.04
To install the eglinfo utility

Run the following command:

$ sudo apt install mesa-utils

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.

Note

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.

Note
  • 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. To check the compute capabilities, see the NVIDIA Compute Capacility tables.

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 blog post.