Fix a FlightGear white screen by checking OpenGL drivers, GPU choice, graphics settings, preferences, data files and add-ons in the right order.
FlightGear usually shows a white screen when its OpenGL renderer cannot initialise correctly, a graphics setting or shader fails, or the simulator loads incomplete data. Start with a stock aircraft and low graphics settings, update the GPU driver, force the dedicated GPU, then reset FlightGear’s user preferences if the problem remains.
What causes a white screen in FlightGear?
The pattern of the fault usually identifies its cause. A completely white 3D view points towards graphics or weather rendering, while white objects in an otherwise working scene usually indicate missing textures or incompatible add-on content.
| What you see | Likely cause | First action |
|---|---|---|
| White 3D view, but menus still work | OpenGL, shader, cloud or lighting fault | Reduce rendering settings and test clear weather |
| Blank or white launcher | Graphics driver, damaged preferences or installation problem | Reset the user profile and verify the installation |
| Only one aircraft is white | Missing or incompatible aircraft textures | Test a bundled aircraft |
| Only terrain is white | Missing textures, incomplete data, fog or snow | Test another airport in clear daytime conditions |
| Problem occurs through remote desktop or a virtual machine | Limited or software OpenGL rendering | Run FlightGear locally on the host computer |
A short white display during initial resource or shader loading is not necessarily a fault. If the log is still advancing and the application remains responsive, allow it to finish; if no 3D window appears or the process stalls, use our guide to separate start-up failures from rendering faults.
How do I fix the FlightGear white screen?
- Run a controlled test. Select an aircraft supplied with the same FlightGear installation, use a standard airport, choose daytime and set clear weather. Switch between the cockpit and an external view so that cloud, fog or a broken cockpit panel is not mistaken for a failed renderer.
- Reduce graphics options. Start in windowed mode at a moderate resolution. Turn off shadows, detailed clouds, anti-aliasing, post-processing and advanced lighting options where your build provides them, then restart FlightGear. If the scene returns, enable those features individually to find the setting that triggers the fault.
- Install the correct GPU driver. Obtain the driver intended for the installed NVIDIA, AMD or Intel hardware rather than relying on a fallback display driver. Linux users should check that FlightGear is not using software rendering; macOS supplies graphics drivers through the operating system rather than separate vendor installers. Our FlightGear hardware and graphics compatibility checks explain what to verify before raising the settings again.
- Force the proper graphics processor. On a dual-GPU laptop, assign FlightGear to the high-performance GPU through the operating system or graphics control panel. On a desktop, confirm that the monitor is connected to the dedicated graphics card rather than the motherboard output.
- Test outside remote desktop. Remote sessions and virtual machines may expose only limited OpenGL features or a software renderer. Sign in locally and launch the simulator directly before changing anything else.
- Reset FlightGear’s saved preferences. Close the launcher and simulator completely, back up the per-user FlightGear profile, then use the build’s restore-defaults option or rename that profile so FlightGear creates a clean one. Many builds store saved properties in a file named
autosave.xml, but its location and exact naming can vary. This reset may remove custom control assignments and content paths, so do not delete the aircraft or scenery installation folders. - Remove custom content from the test. Temporarily disable additional aircraft, scenery paths, materials and shader modifications. Do not copy data folders from one FlightGear release over another: the executable and its
FG_ROOTdata must belong to the same build. If the log reports missing textures, XML files or base resources, follow our instructions for repairing missing or mismatched FlightGear data. - Reinstall only after resetting the profile. A normal uninstall may leave the faulty per-user settings behind, which makes a fresh installation appear broken too. Install a clean, supported package into a fresh location and avoid reusing an old data directory; our library provides a clean FlightGear download and platform information.
How can I tell whether OpenGL is the problem?
FlightGear’s start-up console or log identifies the active renderer and records shader failures. Search it for OpenGL, GLSL, shader, texture and FG_ROOT.
- A renderer such as
llvmpipeon Linux indicates software rendering rather than normal GPU acceleration. - Repeated shader compilation errors point towards an unsupported feature, unsuitable graphics setting or driver fault.
- Missing texture and file-path messages point towards aircraft, scenery or base-data problems instead.
- If a different GPU appears in the log from the one you selected, correct the operating-system GPU assignment before reinstalling FlightGear.
Do not download a random opengl.dll or copy one into FlightGear’s programme folder. OpenGL support should come from the proper graphics driver; an unrelated DLL can force the wrong renderer, introduce further errors or create a security risk.
Why is only the aircraft or scenery white?
If menus, sky and instruments render normally, the graphics system has at least started successfully. A single white aircraft normally has missing texture files, texture names with incorrect letter case on case-sensitive systems, or an add-on built for a different FlightGear data structure.
White terrain needs a second test in clear daytime weather at a different airport. If the fault follows one scenery package, remove or reinstall that package; if every location is affected and the log reports missing materials or textures, repair the base data rather than repeatedly downloading scenery.
Will reinstalling FlightGear fix a white screen?
Reinstallation fixes damaged or mixed-version programme data, but it does not repair an incompatible driver and may not remove saved preferences. Reset the user profile first, then reinstall only if a stock aircraft still produces a white display with conservative graphics settings and the correct GPU active.