How do you run ArduPilot SITL on an Apple Silicon Mac?

Last updated November 15, 2026 · By the Fly Before team

You build it from source: there is no ready-made macOS SITL binary on ArduPilot's firmware server. On a current Mac with Xcode 26 the build needs a one-line linker workaround, then takes a few minutes. If you only want to fly and rehearse, Fly Before ships ArduPlane SITL as a separate helper and starts it with one switch.

Fly Before is the RC flight simulator for Mac that runs real ArduPilot in one click. Plug in your radio and practice every step on your Mac before you go to the field. See what Fly Before does

SITL ("software in the loop") is the real ArduPilot flight-controller code compiled to run on a computer instead of a flight controller. It is how ArduPilot developers test, and it is a good way to rehearse a mission, a failsafe or a QuadPlane transition before you risk an airframe. On Linux it is routine. On a Mac it has a reputation for build errors. Below is the manual route as we did it on November 14, 2026, followed by the shortcut.

Route A: build it yourself

What we used: ArduPilot tag Plane-4.7.2, Apple clang from Xcode, Python 3.12 from Homebrew, no Docker.

  1. Get the source. Clone the ArduPilot repository, check out a Plane release tag (we used Plane-4.7.2) and fetch the submodules. A shallow clone (--depth 1 --shallow-submodules) saves time and disk.
  2. Make a Python environment. Create a venv and install empy==3.3.4, pexpect, future, lxml, pymavlink and numpy. The build scripts need the old 3.3.4 version of empy.
  3. Configure for SITL. With the venv on your PATH, run ./waf configure --board sitl.
  4. Build ArduPlane. Run ./waf plane. On our Apple Silicon Mac it took about four minutes. The binary lands in build/sitl/bin/arduplane.
  5. Start it with a physics backend and your parameter files, then connect a ground station (see below).

The Xcode 26 linker error

With Xcode 26, the new linker no longer accepts the -ld_classic flag that ArduPilot (4.7.2 and master at the time) passes for clang 15 and newer. The new linker also stops with a pointer not aligned error on a packed structure. Our local workaround was one line in Tools/ardupilotwaf/boards.py: replace -Wl,-dead_strip,-ld_classic with -Wl,-dead_strip,-no_fixup_chains. The error becomes a warning and the binary runs. If you update the repository, check with git diff whether you need it again.

Other things that bite

Ports you will meet

PortDirectionUsed by
UDP 9002ArduPilot sends servo outputs to the physics backendJSON physics backend (the simulator)
UDP 14550ArduPilot sends MAVLink to 127.0.0.1QGroundControl, which listens on 14550 by default
TCP 5760ArduPilot listens on all interfacesMission Planner, MAVProxy, or a QGroundControl TCP link; one client at a time

For a second SITL instance, all ports move up by 10.

Route B: the one-click way

Fly Before runs the same ArduPlane 4.7 SITL, built for Apple Silicon, as a separate free helper. The simulator provides the physics over ArduPilot's JSON interface, and you never touch a compiler.

  1. Download the ArduPilot helper next to the app.
  2. In Settings, Connections, turn on Fly with ArduPilot. The app starts ArduPilot with the parameter file for your plane and stops it when you finish, even if the app quits unexpectedly.
  3. Arm with throttle down and rudder full right for three seconds, then fly FBWA, AUTO, RTL or LOITER from a six-position mode switch.
  4. Connect QGroundControl over UDP 14550 or TCP 5760.

FBWA, RTL, automatic takeoff and landing, AUTO missions, radio, battery and geofence failsafes and the QuadPlane transition pass our automated test runs against ArduPlane 4.7.2 SITL, and all 43 aircraft fly under it.

The Trainer flying over farmland under real ArduPilot; the status reads ArduPilot, RTL, Armed, with speed 37 mph, height 197 ft and battery 96%

Limits: the helper runs on Apple Silicon only. The flight model estimates inertia, so do not copy PID gains tuned in any simulator straight to your plane. Fly Before is not affiliated with or endorsed by the ArduPilot project.

Questions

Is there a ready-made ArduPilot SITL binary for macOS?

Not on ArduPilot's firmware server when we checked: it offers SITL builds for Windows (for Mission Planner) and Linux, not macOS. On a Mac you build it from source or use an app that ships it.

How long does building ArduPlane SITL take on an Apple Silicon Mac?

In our build, about four minutes for ./waf plane after configuring with --board sitl.

Does SITL fly a plane by itself?

No. SITL is the autopilot software. It needs a physics model to fly: ArduPilot's built-in simple models, or an external simulator connected over its JSON or other backends.

Fly Before: RC Flight Simulator is a native macOS app (Apple Silicon) for flying RC planes and fixed-wing VTOLs that runs real ArduPilot in one click through the free ArduPilot Helper. One-time purchase, not on sale yet.

Sources

Changelog

Fly it before you fly it

Native on Apple Silicon Macs. Real ArduPilot in one click. Your own radio or a PS5 controller: the setup wizard learns any USB controller in four stick moves.

Watch it fly

$49.99 once, everything included · On sale soonRequirements