Common problems with version 0.14/0.15

Created by gzotti on on 2015-10-24
Last updated by:
gzotti on on 2017-05-13


Hardware requirements have not changed since V0.13 (see FAQ on Common Problems with V0.13 ).

>>Particular note for Windows 10 upgraders: <<
If you upgrade some older computer, you may have to also upgrade graphics drivers manually. Not all graphics card manufacturers provide drivers for Win10 explicitly for their old hardware, but some drivers for Win7/Win8 may work. If Stellarium V0.11 worked for you some years ago, it should work also here. If the hardware allows it, V0.14 will also work. Don't expect latest programs to run on outdated hardware without latest drivers though.
>> END of Windows 10 note.<<

Instead of special packages for older hardware, thanks to developments in Qt5.5 the Windows version now comes with links to force alternative graphics modes: ANGLE (OpenGL to DirectX translation) or MESA (software rendering). Modern hardware should be able to run the untagged "Stellarium" link, and you can happily delete the ANGLE and MESA startup links. Older hardware may require the special links and maybe even special handling which we learned ourselves from :

We have first reports about missing buttons which seem to be related to errors in the ANGLE driver in its default Direct3D11 mode on older Intel GMA graphics. If the logfile indicates something about GL renderer is "ANGLE (XXXXXXXXXXXXXX Direct3D11 vs_x_0 ps_y_0)" , you may be lucky if you set an environment variable QT_ANGLE_PLATFORM=d3d9 or even QT_ANGLE_PLATFORM=warp. Of course, the requirements vs_2_0/ps_3_0 or better remain the same for hardware acceleration. Setting environment varlables is described e.g. here:

V0.14.1 comes with two extra links: --angle-d3d9 and --angle-d3d11, which force the respective modes. So,

--angle-d3d9 should be tried if you just cannot see the menu buttons.

It appears that on some hardware even the MESA version which should emulate a proper GPU fails. It is very unclear at the moment what we could do here. Software rendering is also available via ANGLE, so maybe try the ANGLE version with environment variable QT_ANGLE_PLATFORM=warp (V0.14.1 directly provides option --angle-warp, but it also appears not to work on some systems where native OpenGL works...) and please report with your logfile if this helps. Alternatively, please copy the file opengl32.dll from an earlier version into the Stellarium 0.14 program folder and rename it to opengl32sw.dll. This worked in one case, but not in another.

We have reports that upgrading to El Capitan solved graphic issues. One user's Mac still crashed when zooming in on ringed planets. As always, workarounds, hints, patches welcome.

If for whatever reasons you run Stellarium inside a virtual machine and your driver is configured to report in the logfile as:
GL renderer is "Gallium 0.4 on SVGA3D; build: RELEASE; LLVM;"

Hugo Rodde wrote:
My solution was to downgrade OpenGL from 3.3 to 2.1 as written here:

* Ubuntu 14.04
* VMware Fusion 8

OpenGL 3.3 support can be disabled by setting the environment variable SVGA_VGPU10=0. You will then have OpenGL 2.1 support. This may be useful to work around application bugs (such as incorrect use of the OpenGL 3.x core profile).

So do the following:
$ echo "export SVGA_VGPU10=0" >> ~/.bashrc
There followed a confirmation that this works.

Qt is collecting a blacklist of insufficient devices here:
If your device is listed, see the known limitations. If both OpenGL and ANGLE/Direct3D are disabled, you are out of luck. Try if version 0.12.9 works, in --no-opengl2-mode.


Still an issue in this version. Some users reported mouse cursor is invisible. This is true for the default OpenGL mode on Windows when you have Mouse Trails enabled or another reason to use a "software cursor", like f.lux screen color temperature modifier.

Make sure to switch off mouse trails to avoid this problem.

An anonymous user has reported a workaround: Use ANGLE mode when you need mouse trails or f.lux.

On Windows and with some older models of NVidia GeForce (reported for 580M, 770), the color settings dialog in the gridline panel and ArchaeoLines plugin hides when Stellarium is running in Fullscreen and OpenGL mode. The color dialog works in ANGLE mode. On a GeForce GTX 960M we see no problem.

We interpret this as NVidia driver issue. If you are affected, run Stellarium in ANGLE mode.

We had reports that on some Windows systems the star catalog update does not work. See the logfile for these messages:

Error downloading star4:
Error creating SSL context ()

To solve, user Austin has tested this solution (

1) Go here:
2) Download latest OpenSSL file.
(I downloaded "".)
3) Open the zipped archive and find these two files:
4) Extract these 2 files to the main folder of your Stellarium installation.
(For example: C:\Program Files\Stellarium\ )

Start Stellarium, and the star catalog updater should now work perfectly fine.
The libraries have been packed into our beta installers for Windows after 0.15.1.


There was a change in the star catalogs, and I had such a "zoom to 5° crash" during development. Extra stars should be in C:/Users/YOU/AppData/Roaming/Stellarium/stars/default. Simply rename default and try again please. If this helps, delete the renamed folder and re-download the updated catalogs. (A new folder "default" will be created on launch.)