FlightGear 9 min read 237 views

How do I set up FlightGear for the first time?

Adam McEnroe
In short

Set up FlightGear Launcher, FGData, scenery and controls, then fix missing aircraft, slow starts, broken terrain and input problems.

To set up FlightGear for the first time, install one complete stable package, open FlightGear Launcher, choose the included Cessna 172P and a runway start, enable TerraSync, test every control axis, and make one short flight with clear weather and conservative graphics settings before adding aircraft or scenery.

Here, FlightGear means the open-source flight simulator, sometimes written as Flight Gear, rather than physical flying equipment.

FlightGear first-time setup, step by step

For the first run, keep FlightGear stock and remove as many variables as possible.

  1. Install one complete FlightGear release. Use the package intended for your operating system and keep its application and base data from the same release. Windows users can follow our full PC installation procedure. Do not combine a newer executable with base data copied from an older installation.
  2. Open FlightGear Launcher. The launcher should display the included aircraft without asking you to find individual files. An empty aircraft list usually means that its base-data path is missing or incorrect.
  3. Select the Cessna 172P. This included trainer has conventional flight controls and is easier to diagnose than a helicopter, fast jet or systems-heavy airliner.
  4. Choose a runway start. Search by airport name or ICAO code and select a paved runway at a quiet airport. A runway start avoids the cold-and-dark state, pushback and ground-navigation problems associated with some parking positions.
  5. Use simple conditions. Select daylight, clear visibility and little or no wind. If the aircraft offers a saved state, choose an engine-running or ready-for-take-off state for this initial check.
  6. Enable TerraSync. Put its scenery cache in a permanent, user-writable folder with sufficient free storage. Keep it outside protected application directories; our TerraSync configuration guide explains the cache and download settings.
  7. Configure only the essential controls. Assign pitch, roll, rudder and throttle, then test their direction before moving. If a joystick, yoke, throttle quadrant or gamepad is not recognised correctly, use our FlightGear controller setup instructions.
  8. Keep the default rendering mode. Begin with moderate cloud detail, shadows, visibility and anti-aliasing. Advanced rendering options and custom launch arguments should wait until the simulator works reliably.
  9. Press Fly and perform a ground test. Confirm that the cockpit loads, release the parking brake, apply a small amount of power, test steering and brakes, then return the throttle to idle. Attempt a take-off only after every primary control responds correctly.

A mistake we see repeatedly is installing extra aircraft, custom scenery and experimental command-line options before the standard simulator has completed one successful flight. Establish a working baseline first; later faults are then much easier to isolate.

How do I use FlightGear Launcher and choose FGData?

Use FlightGear Launcher to choose the aircraft, starting position, environment and simulator options; point it to FGData only if it cannot locate the matching base data automatically.

A search for “fly launcher” usually refers to FlightGear Launcher, not a separate add-on. Press its Fly control, or the equivalent start control used by your build, after selecting the aircraft and location.

DirectoryWhat it containsHow FlightGear should use it
FGDataCore configuration, instruments, models and bundled aircraft dataUse the top-level base-data directory supplied with the same FlightGear release.
TerraSync cacheAutomatically downloaded terrain, objects and related sceneryUse a separate permanent folder that your user account can write to.
Additional aircraft folderAircraft installed after the base simulatorRegister it as an aircraft search path rather than mistaking it for FGData.

FGData is not the TerraSync cache, an individual aircraft directory or the Aircraft child folder. Packaged installations normally configure it without user intervention. Manual selection is mainly needed after moving files, using a source-based installation or changing launch options.

If the launcher lists no aircraft, reports missing base files or stops before the cockpit appears, check that the program and FGData came from the same release. Reinstalling a complete matching package is usually safer than replacing individual files.

Numbered instructions do not transfer reliably between launcher versions. If a translated guide says la opción 3, meaning “option 3”, match the setting's stated purpose rather than selecting the third visible item blindly; launcher order and labels can change between packages.

How do I play FlightGear after setup?

To play FlightGear, load a simple aircraft on a runway, verify its controls, release the brakes, add power smoothly and complete a short take-off, circuit and landing before enabling more complex features.

  1. Check the cockpit state. Confirm that the engine is running, the throttle responds and no warning indicates an obviously unsafe configuration.
  2. Move each control separately. Test pitch, roll and rudder while stationary. A control that jumps, moves backwards or will not centre usually has a reversed or duplicate axis assignment.
  3. Test taxi control. Release the parking brake, apply low power and check steering and wheel brakes. Stop immediately if the aircraft pulls strongly to one side or accelerates unexpectedly.
  4. Take off smoothly. Line up with the runway, increase power progressively, use rudder to remain near the centreline and raise the nose gently once the aircraft has adequate airspeed. Exact speeds depend on aircraft state, loading and model.
  5. Keep the first flight local. Fly a simple circuit close to the airport. This checks scenery loading, trim, views and frame rate without adding navigation or weather complications.

A joystick or yoke is not mandatory. Keyboard and mouse input can verify that FlightGear works, but analogue pitch and roll axes make accurate flying much easier. Bind only essential controls initially, and disconnect unused gamepads if an unexplained axis keeps overriding the device you intend to use.

If the aircraft constantly climbs or dives despite centred controls, check trim before changing controller sensitivity. If an axis jitters while untouched, calibrate it through the operating system and apply only a small dead zone; a large dead zone removes useful control near the centre.

How should I set up FlightGear scenery and graphics?

Use TerraSync for automatic scenery coverage and leave graphics close to their defaults until the same airport loads correctly more than once.

Scenery baseline

TerraSync downloads the tiles required around your selected location and retains them in its cache. A first visit may therefore load slowly or show water, flat terrain, missing buildings or incomplete airport detail while the files arrive. Confirm that downloading has finished, then reload the location if necessary.

Choose TerraSync when you have an internet connection and want scenery fetched automatically. Use manually installed scenery when preparing an offline route or adding a specific custom region, but do that only after automatic scenery works. Mixing several scenery paths too early can cause duplicate objects or unexpected overrides.

If scenery downloads again every session, the cache path is changing, the directory is not writable or a cleanup utility is deleting it. Select one permanent location and confirm that its files remain after FlightGear closes.

Graphics baseline

Poor frame rate should be addressed one setting at a time. Reduce shadows, cloud detail, visibility and anti-aliasing, testing the same aircraft and airport after each change. This reveals which option is expensive on that computer.

Missing terrain is a scenery problem, not a reason to reduce graphics quality. A black or blank simulator window points more often to the graphics driver, an incompatible rendering option or damaged saved preferences than to TerraSync.

Can I install a FlightGear A380 straight away?

You can add a FlightGear Airbus A380 after the stock simulator works, but an A380 is not guaranteed to be included and is a poor aircraft for diagnosing a first installation.

Aircraft availability and compatibility vary by FlightGear release and package. Complex airliners may also have incomplete systems, special start procedures or heavier performance requirements. Test the Cessna first, then follow our guide to installing and registering additional FlightGear aircraft.

Keep add-on aircraft outside the bundled FGData directory where the package supports a separate aircraft path. This makes updates less likely to overwrite them. Aircraft built for Microsoft Flight Simulator, X-Plane or another simulator cannot be installed in FlightGear because their formats and systems are different.

First-launch problems and fixes

One slow first launch can be normal while caches and scenery are prepared, but repeated stalls usually indicate mismatched FGData, an unwritable cache, incompatible graphics preferences or conflicting input devices.

SymptomLikely causeFirst fix
No aircraft appear in FlightGear LauncherFGData is missing, mismatched or pointed at the wrong directory levelRestore the complete matching package and select the top-level base-data directory, not its Aircraft folder.
The launcher works but the cockpit never appearsCustom launch argument, damaged preferences or mismatched program and dataRemove custom arguments, return to default preferences and confirm that the application and FGData belong to the same release.
The airport is in water or terrain is absentThe required scenery tile has not downloadedCheck TerraSync, network access, cache permissions and available storage, then let the download finish.
The aircraft ignores or fights the controlsReversed axis, duplicate binding or another connected controllerTest one device at a time, clear duplicate assignments and check each axis direction.
The aircraft will not taxiParking brake, wheel brakes, engine state or throttle assignmentConfirm that the engine is running, release the parking brake and inspect throttle and brake inputs.
The aircraft pulls hard to one sidePartly applied brake, rudder input or reversed pedal axisCentre the controls and inspect the live brake and rudder inputs before changing the aircraft model.
Black, white or crashing displayGraphics driver, advanced renderer or incompatible saved preferenceReturn graphics options to defaults, remove experimental launch settings and verify the installed graphics driver.
Scenery downloads every sessionThe cache is temporary, changing or not writableChoose one permanent user-writable cache and verify that downloaded files persist after closing FlightGear.

Before reinstalling, remove custom command-line options and rename the per-user preferences directory so it can be restored later; its exact location varies by operating system and package. Also inspect the simulator output for the first meaningful error, since later messages may only be consequences of the original failure.

The first-time setup is complete when FlightGear loads the cockpit reliably, displays local terrain, retains downloaded scenery, responds correctly to every primary control and lets the aircraft taxi and take off without unexplained braking or steering. Add live weather, navigation equipment, extra aircraft and custom scenery one change at a time after that.

AI Assistant New

Still stuck? Ask Fly Away

Ask Fly Away is our AI flight-sim assistant. Ask your exact question and get a direct, step-by-step answer in seconds — free to try.

Ask Fly Away Free preview · unlimited for PRO members