Skip to content

Support

Help & community.

If something is broken or you are stuck, Discord is the fastest way through. Most questions get an answer the same day.

Fastest answer

Join the Discord

Talk with other X-Plane pilots, see what is being worked on, and get help when something breaks.

Join the Discord

Report a problem

Found a bug? Drop a short reproduction in support and we will take a look.

Support development

X-Dispatch is free. If it earned a spot in your flow, a small tip helps keep it moving.

Email

hello@x-dispatch.app

Slower than Discord, but private. Replies usually land within a day.

Before first launch

Getting it open on your machine.

X-Dispatch isn't code-signed yet, so macOS blocks first launch. Strip the quarantine flag once and you're set.

  1. 1.Open the downloaded .dmg. In the window that opens, drag the X-Dispatch icon into the Applications folder.
  2. 2.Open Terminal (⌘+Space, type "Terminal", press Enter).
  3. 3.Paste this and press Enter:
    sudo xattr -rd com.apple.quarantine /Applications/X-Dispatch.app
  4. 4.Enter your Mac password when prompted. No dots or characters show as you type. That's normal, just type and press Enter.
  5. 5.Open X-Dispatch from your Applications folder.

If something fails, drop a note in Discord rather than retrying random commands.

FAQ

Frequently asked.

Real questions from Discord and X-Plane.org. If yours is not here, ask in Discord.

  • InstallmacOS says "X-Dispatch is damaged and can't be opened."

    macOS blocks unsigned apps by default, and the build is not notarized. Drop the .app into /Applications, then in Terminal run xattr -rd com.apple.quarantine /Applications/X-Dispatch.app. If macOS still refuses, prefix the same command with sudo. The binary is fine; this just tells Gatekeeper to stop blocking it.

  • InstallI get "operation not permitted" reading X-Plane files.

    macOS will not let an app read folders outside its sandbox until you grant permission. Open System Settings → Privacy & Security → Files and Folders, find X-Dispatch, and turn on access for wherever your X-Plane install lives. On Windows, try running X-Dispatch as administrator. Close X-Plane and any scenery tool first, since they hold file locks that block the read.

  • InstallLinux: the AppImage won't open.

    First, give it the executable bit: chmod +x X-Dispatch-*.AppImage. On Ubuntu 24.04+ the kernel restricts unprivileged user namespaces by default (AppArmor), and Fedora 44+ ships only fuse3-libs so the AppImage type2 runtime cannot mount. Both fail with a FUSE error or "Cannot open /proc/self/exe: Permission denied". The fix in both cases is the extract-and-run flag: ./X-Dispatch-*.AppImage --appimage-extract-and-run. Do not run X-Dispatch with sudo — it breaks your X session.

  • CompatibilityDoes it work with X-Plane 11?

    No. X-Dispatch needs X-Plane 12.4 or newer. The handoff it uses to start your flight did not exist in earlier versions.

  • CompatibilityIs it compatible with X-Plane Map Enhancement?

    Yes. In X-Dispatch, go to Settings → Companion Apps and add an entry pointing at the Map Enhancement executable (on macOS that is /Applications/X-Plane Map Enhancement.app). Put --start-service in the arguments field. X-Dispatch will launch it next to X-Plane when you press Launch. The same panel handles XPME, ATC clients, hardware drivers, and anything else you normally start with the sim.

  • CompatibilityDoes it support symlinked scenery and aircraft folders?

    Yes. Symbolic links are followed when X-Dispatch scans your X-Plane install, so you can keep scenery and aircraft on a separate drive.

  • UsageHow do I select a gate before launching?

    Open the airport, click the gate marker directly on the diagram, then press Launch. The picked gate shows up as the ramp start in your flight config. If you see "no gate selected" even after picking one, restart X-Dispatch and try again. There is a stale-state bug we are chasing.

  • ProjectIs X-Dispatch free?

    Yes. X-Dispatch is free to download and use. No account, no subscription.