Software⏱️ 3 min read📅 2026-06-11

How to Fix: Error on changing the resolution of a vnc session in linux on the fly

Error on changing VNC resolution in Linux on the fly

Quick Answer: The error indicates that the RANDR extension is missing on your display. You need to install and enable Xrandr to fix this issue.

The error 'Xlib: extension "RANDR" missing on display ":1.0"' occurs when the Linux system is unable to find the RANDR extension, which is required for dynamic resolution changes in VNC sessions. This affects users who need to switch between different resolutions and displays, such as those using docking stations or laptops with varying screen sizes.

This error can be frustrating because it requires restarting the VNC server every time a display change is needed, leading to increased downtime and decreased productivity. In this guide, we will walk through the steps to troubleshoot and resolve this issue.

⚠️ Common Causes

  • The first main reason why this error happens is that the Linux system does not have the RANDR extension installed or enabled. This can occur if the xrandr package is not installed or not configured correctly. To fix this, ensure that the xrandr package is installed and up-to-date.
  • An alternative reason for this error could be that the display device (e.g., a docking station) does not support the RANDR extension or has it disabled. In this case, the VNC server may not be able to detect the available display devices and their resolutions.

🔧 Proven Troubleshooting Steps

Enabling RANDR Extension

  1. Step 1: To enable the RANDR extension, run the command `sudo apt-get install xrandr` (for Red Hat Linux) or `sudo yum install xorg-xrandr` (for other distributions). This will ensure that the necessary package is installed and configured correctly.
  2. Step 2: After installation, restart the X server by running `sudo service xorg restart` or `sudo systemctl restart xorg`. This will apply any changes made to the display configuration.
  3. Step 3: Verify that the RANDR extension is enabled by running `xrandr --list-outputs`. This command should list all available display devices and their resolutions.

Configuring VNC Server with Dynamic Resolution

  1. Step 1: To configure the VNC server to use dynamic resolution changes, modify the `/etc/VNC/vncserver.conf` file. Add or modify the `geometry` and `randr` arguments as needed.
  2. Step 2: For example, add the following lines to the `[vnc] ` section: `geometry 1600x1200` and `randr 1600x1200,1440x900,1024x768`. Save the changes and restart the VNC server by running `sudo systemctl restart vncserver` or `sudo service vncserver restart`.

✨ Wrapping Up

To resolve the 'Xlib: extension "RANDR" missing on display ":1.0"' error, ensure that the RANDR extension is installed and enabled on your Linux system. If this is not possible, configure the VNC server to use dynamic resolution changes using the `randr` argument.

Did this fix your problem?

If not, try searching for specific error codes.

🔍 Search Error Database

❓ Frequently Asked Questions