Install OpenGL on Ubuntu in WSL

opengl-in-wsl.md

How to Install OpenGL in Ubuntu in WSL2

These steps have been tested on Windows 10 with WSL2 running Ubuntu.

1. Dependencies

First install the dependencies:

apt install mesa-utils libglu1-mesa-dev freeglut3-dev mesa-common-dev

There are more than we need, but also include GLut and Glu libraries to link aginst during compilation for application development (these can be removed if that functionality is not required).

2. Window Server

Installing

Then, you will need to setup a window server. Windows 11 should have this built in and work out of the box (skip to step 3). In Windows 10 you will need to install one VcXsrv is a popular option (also known as XLaunch).

Configuration

Once installed, then you will need to make a configuration. You want the following settings:

• First Screen: Multi-Window, Display=0

• Second Screen: Start No Client

• Third Screen: Clipboard=True, Primary Selection=True, Native OpenGL=False, Disable Access Control=True

I recomend you save your configuration file somewhere so that each time you start you window server you can open it instead of rebuilding it. Then start your window server.

WSL Display

Once you have setup and started your Window server, you need to tell Ubuntu/WSL where your display is, we can do this by running the following command:

export DISPLAY=$(awk '/nameserver / {print $2; exit}' /etc/resolv.conf 2>/dev/null):0
export LIBGL_ALWAYS_INDIRECT=0

You will need to do this for every new shell you open. Alternatively, you can add this to your .bashrc file to have your shell do it for you an start up.

3. Running a Test

After the following configuration you should be able to run the test application below and see some multi-colored gears spinning:

glxgears

On windows 11 with WSL2, on running "glxgears", a black window opens. I can expand / minimize & close the window but the content is all black. I don't see any multi-colored gears spinning.

Does anyone have a similar issue? Can someone suggest a fix?

on windows 10 with WSL2 i don't see anything with glxgears. no window, not even black.

On windows 11 with WSL2, on running "glxgears", a black window opens. I can expand / minimize & close the window but the content is all black. I don't see any multi-colored gears spinning.

Does anyone have a similar issue? Can someone suggest a fix?

It is possible you have some sort of driver issue. If you see a window your windowing system is setup. Maybe just double check your window manager settings. I found I got black screens when I changed settings from what is above. Specifically, Native OpenGL.

on windows 10 with WSL2 i don't see anything with glxgears. no window, not even black.

Do you see any errors about being unable to find a display/the DISPLAY environment variable? Not seeing a window would suggest to me it cannot find your window manager.

window manager? you mean vcXsrv?? if i wait long enough, glxinfo eventually says it's unable to find open the display. i was thinking a driver issue too, but not sure how to fix or check that.

window manager? you mean vcXsrv?? if i wait long enough, glxinfo eventually says it's unable to find the display. i was thinking a driver issue too, but not sure how to fix or check that.

@bjarthur Yes, vcXsrv is your window manager in this case. If you are seeing the "Unable to find a display" error, that means your window manager is either not setup correctly, not running, or your DISPLAY environment variable is not pointing correctly to your window manager. If you run echo $DISPLAY, what is printed?

DISPLAY was set to an IPaddress, but the wrong one. i changed it to be the same as the one in network settings and it now works. thanks!

DISPLAY was set to an IPaddress, but the wrong one. i changed it to be the same as the one in network settings and it now works. thanks!

Great to hear! Did you use export DISPLAY=$(awk '/nameserver / {print $2; exit}' /etc/resolv.conf 2>/dev/null):0 in your terminal/RC file, or was it set some other way? Just want to check if you hit a case where this doesn't work.

this command above didn't work for me: export DISPLAY=$(awk '/nameserver / {print $2; exit}' /etc/resolv.conf 2>/dev/null):0. i had to lookup my correct ipaddr in network settings and set the envvar in .bashrc manually.

On windows 11 with WSL2, on running "glxgears", a black window opens. I can expand / minimize & close the window but the content is all black. I don't see any multi-colored gears spinning.

Does anyone have a similar issue? Can someone suggest a fix?

I'm encountering the exact same issue on Windows 11 with WSL2. Upon running glxgears, the native Windows Server for Windows 11 launches, but it only displays a black screen. Whilst the terminal outputs values like "frames in 5.0 seconds," there's no actual visual output. I decided to test VcXsrv to see if it would yield different results, but unfortunately, the same problem persists - this time with an even worse frame rate for the black screen.

Comments suggest that this could potentially stem from a driver problem, given that a window does appear, or that it might be related to window manager settings. However, I'm unsure how to address these concerns within the built-in Windows 11 Windows Server.

Does anyone have any suggestions or recommendations for troubleshooting this?

I got this window

I got also this flickering window when I ran an application from within Ubuntu/wsl