Support

Help & community.

X-Dispatch is open source. 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.

  • Install macOS 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.

  • Install I 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.

  • Install Linux: 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.

  • Compatibility Does 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.

  • Compatibility Is 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.

  • Compatibility Does 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.

  • Usage How 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.

  • Project Is X-Dispatch open source? Can I contribute?

    Yes. X-Dispatch is free and released under GPL-3.0. PRs are welcome on the GitHub repo. If you are planning something larger, open an issue first so we can talk about it before you sink time in.