Recent Changes - Search:

TurboVNC Home

About TurboVNC

Downloads

Documentation

Reports

Developer Info

Contact

Related Projects

TurboVNC 2.2.x Window Manager Compatibility Report

The following window manager configurations have been tested either by us or by the TurboVNC community using the TurboVNC 2.2.x X server. If you know of any issues that are not described here, please submit a bug report. If you have information about other WM configurations, please contact us.

O/SWindow ManagerHow to EnableNotes
Debian 9.0 "Stretch"MATE 1.16.xexport TVNC_WM=mate-sessionMust enable MATE in the prescribed manner in order to avoid this issue
Fedora 25GNOME 3.22.x Run the window manager using VirtualGL to improve performance

See complete list of known GNOME 3 issues and workarounds here
 GNOME 3.22.x (classic)export TVNC_WM=2dSee complete list of known GNOME 3 issues and workarounds here
 MATE 1.18.x> sudo dnf group install mate-desktop-environment
> export TVNC_WM=mate-session
No known issues
Fedora 26GNOME 3.24.x Run the window manager using VirtualGL to improve performance

See complete list of known GNOME 3 issues and workarounds here
 GNOME 3.24.x (classic)export TVNC_WM=2dSee complete list of known GNOME 3 issues and workarounds here
 MATE 1.18.x> sudo dnf group install mate-desktop-environment
> export TVNC_WM=mate-session
No known issues
FreeBSD 10.3MATE 1.12.xInstall with FreeBSD Ports
export TVNC_WM=mate-session
No known issues
OS XTWMInstall XQuartzOpenGL does not work, for unknown reasons
Red Hat Enterprise Linux 5 (and equivalents)GNOME 2.16.x GLX extension not enabled (Mesa package provided by the O/S is too old)
 KDE 3.5.xswitchdesk kde (this also sets the default WM for local logins) or export TVNC_WM=startkdeGLX extension not enabled (Mesa package provided by the O/S is too old)
Red Hat Enterprise Linux 6 (and equivalents)GNOME 2.28.x No known issues
 KDE 4.3.xexport TVNC_WM=startkdeNo known issues
 XFCE 4.8.xAdd the EPEL repository
> sudo yum groupinstall Xfce
> export TVNC_WM=xfce4-session
No known issues
Red Hat Enterprise Linux 7 (and equivalents)GNOME 3.14.x Run the window manager using VirtualGL to improve performance

See complete list of known GNOME 3 issues and workarounds here
 GNOME 3.14.x (classic)export TVNC_WM=2dSee complete list of known GNOME 3 issues and workarounds here
 KDE 4.10.xexport TVNC_WM=startkdeNo known issues
 MATE 1.14.xAdd the EPEL repository
> sudo yum groupinstall "MATE Desktop"
> export TVNC_WM=mate-session
No known issues
Solaris 10GNOME 2.6.x May need to add -extension Composite to the vncserver command line to disable the Composite extension. This is not necessary in order to run the window manager itself, but it may be necessary in order to work around issues with certain applications.
Solaris 11GNOME 2.30.x No known issues
SuSE Linux Enterprise 11GNOME 2.24.x No known issues
 KDE 4.1.xexport TVNC_WM=startkdeNo known issues
SuSE Linux Enterprise 12GNOME 3.14.x Run the window manager using VirtualGL to improve performance

See complete list of known GNOME 3 issues and workarounds here
Ubuntu 10.04 LTSGNOME 2.30.x No known issues
Ubuntu 12.04 LTSUnity 5.12.x/5.14.x No known issues
 Unity 2D 5.12.x/5.14.xexport TVNC_WM=2dNo known issues
Ubuntu 14.04 LTSGNOME 3.8.x (fallback)export TVNC_WM=2dNo known issues
 MATE 1.8.x> sudo apt-get install mate
> export TVNC_WM=mate-session
No known issues
 Unity 7.2.x Run the window manager using VirtualGL to improve performance
Ubuntu 16.04 LTSGNOME 3.18.x (flashback-metacity)export TVNC_WM=2dNo known issues
 MATE 1.12.x> sudo apt-get install mate
> export TVNC_WM=mate-session
No known issues
 Unity 7.4.x Run the window manager using VirtualGL to improve performance

See complete list of known Unity 7.4 issues and workarounds here

3D Window Managers

Some recent window managers (GNOME 3 and Unity, in particular) require OpenGL in order to run, and other window managers may optionally require OpenGL in order to enable desktop effects. The TurboVNC Server includes a software OpenGL implementation that can be used to run these window managers, but the performance will not be stellar. It is generally recommended that a 2D window manager, such as MATE or XFCE, be used with TurboVNC, but you can also improve the performance of 3D window managers by running them using VirtualGL (VirtualGL 2.4 or later required.) To enable this feature, pass an argument of -vgl to /opt/TurboVNC/bin/vncserver.

Persistent Screen Resolution

Many window managers provide an applet for specifying the screen resolution. This applet interacts with the X RANDR extension, and since that extension is fully supported in TurboVNC 2.0 and later, the built-in screen resolution applet in the window manager can be used to change the size of the TurboVNC desktop. However, it should be noted that, at least in the case of GNOME and KDE, setting the TurboVNC desktop size in this manner may cause the desktop size to persist when you launch a new TurboVNC session. This is because, when the screen resolution is changed using the screen resolution applet in GNOME and KDE, the applet stores the new value and attempts to set the screen resolution to that value the next time the window manager is launched (effectively circumventing the -geometry argument to vncserver.) Notes on the behavior of specific window managers are included below for reference:

O/SWindow ManagerScreen Resolution Set Using...Screen Resolution PersistencePersistent Resolution Stored In...How to Clear Persistent Resolution
Red Hat Enterprise Linux 5 (and equivalents)GNOME 2.16.xSystem-->Preferences-->Screen ResolutionAlwaysGConf /desktop/gnome/screen/default/0/resolutiongconftool-2 -u /desktop/gnome/screen/default/0/resolution
 KDE 3.5.xControl Center-->Peripherals-->DisplayWhen "Apply settings on KDE startup" is checked in the "Display" applet prior to clicking "Apply"N/AUncheck "Apply settings on KDE startup" in the Display applet, and click "Apply"
Red Hat Enterprise Linux 6 (and equivalents)GNOME 2.28.xSystem-->Preferences-->DisplayAlways. GNOME 2.28.x seems to want to aggressively maintain the new resolution once it is set, and this can cause an infinite desktop resize loop if using the TurboVNC Viewer with automatic desktop resizing enabled, and if attempting to set the server's resolution to a size larger than the viewer can display.~/.config/monitors.xml, in a configuration node containing <output name="TurboVNC">Edit ~/.config/monitors.xml, removing the TurboVNC configuration node
 KDE 4.3.xSystem Settings-->DisplayOnly when krandrtray is configured to run at login or when the Display applet is relaunched.~/.kde/share/config/krandrrc, in a section named [Screen_*_Output_TurboVNC]Edit ~/.kde/share/config/krandrrc, removing the TurboVNC section
Red Hat Enterprise Linux 7 (and equivalents)KDE 4.10.xSystem Settings-->DisplayOnly when krandrtray is configured to run at login or when the Display applet is relaunched.~/.kde/share/apps/kscreen/{some_unique_id} (grep for "TurboVNC")Remove the file under ~/.kde/share/apps/kscreen/ that corresponds to the TurboVNC output
 MATE 1.14.xSystem-->Preferences-->DisplayAlways. MATE seems to want to aggressively maintain the new resolution once it is set, and this can cause an infinite desktop resize loop if using the TurboVNC Viewer with automatic desktop resizing enabled, and if attempting to set the server's resolution to a size larger than the viewer can display.~/.config/monitors.xml, in a configuration node containing <output name="TurboVNC">Edit ~/.config/monitors.xml, removing the TurboVNC configuration node

Creative Commons LicenseAll content on this web site is licensed under the Creative Commons Attribution 2.5 License. Any works containing material derived from this web site must cite The VirtualGL Project as the source of the material and list the current URL for the TurboVNC web site.

Edit - History - Print - Recent Changes - Search
Page last modified on September 02, 2017, at 10:37 AM