How do you connect QGroundControl to a simulator on a Mac?

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

Start the simulated ArduPilot flight first, then open QGroundControl: it listens on UDP 14550, where SITL sends MAVLink by default. You can also add a TCP link to 127.0.0.1, port 5760. A tablet on the same Wi-Fi can connect to your Mac's address on port 5760.

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

QGroundControl is the free ground-control station many ArduPilot pilots use to plan missions and change parameters. Pairing it with a simulator is the cheapest way to learn it: you can plan a mission, change failsafe settings and watch the result without a battery on the bench. This quick start uses ArduPlane SITL on a Mac, either built yourself or started by Fly Before.

1. Install QGroundControl

  1. Download the macOS build from qgroundcontrol.com and move it to Applications.
  2. Open it once so macOS can check it. Close it again until ArduPilot is running.

2. Connect

Where QGroundControl runsLink typeAddressNotes
Same Mac (UDP)UDPPort 14550SITL sends MAVLink to 127.0.0.1:14550 by default; QGroundControl listens there by default.
Same Mac (manual)TCP127.0.0.1, port 5760Application Settings, Comm Links, Add, type TCP. One client at a time on this port.
Tablet or phone on the same Wi-FiTCPYour Mac's IP address, port 5760Find the IP in System Settings, Network. SITL listens on all interfaces.
Mission Planner on another PC, or MAVProxyTCPMac IP or 127.0.0.1, port 5760mavproxy.py --master tcp:127.0.0.1:5760

The first time a tablet connects, the macOS firewall may ask whether arduplane may accept incoming connections. Allow it. Guest Wi-Fi networks often block traffic between devices; use your normal network.

3. Three drills worth doing

A short AUTO mission

  1. In Plan view, add a takeoff item, four waypoints in a square around the field, and a landing.
  2. Upload the mission. Download it again and compare; the items should match.
  3. Arm (in Fly Before: throttle down, rudder full right for three seconds), switch to AUTO and watch it fly the square and land.

RTL

  1. Fly out a few hundred meters in FBWA.
  2. Switch to RTL from the radio or from QGroundControl.
  3. Watch the climb to the return altitude and the loiter overhead. Change RTL_ALTITUDE in QGroundControl, fly out again and compare.

Radio failsafe

  1. Check THR_FAILSAFE, FS_SHORT_ACTN and FS_LONG_ACTN in the parameter list.
  2. Fly in FBWA, then cut the radio link (in Fly Before, the "Radio loss" lesson does this for you).
  3. Note what happens at the short and the long timeout. ArduPlane's defaults are an RC failsafe after 1 second, a short failsafe about half a second later, and a long failsafe at 5 seconds; our Trainer parameter file sends the plane home (RTL) at the long failsafe.

4. Logs

How far we have checked this: with a scripted MAVLink ground station acting like QGroundControl, we confirmed heartbeat over TCP, MAVLink arriving on UDP 14550, the full parameter list (1,356 parameters on ArduPlane), parameter write and read-back, mission upload and download, a mode change and "go to location" in GUIDED mode.

Questions

Why does QGroundControl not connect to SITL?

ArduPilot must already be running. QGroundControl listens on UDP 14550 and SITL sends there by default. If nothing appears, add a TCP link to 127.0.0.1 port 5760 in Application Settings, Comm Links.

Can I use QGroundControl on an iPad or Android tablet with a Mac simulator?

Yes, on the same Wi-Fi network. Add a TCP link in QGroundControl on the tablet to your Mac's IP address, port 5760. Guest networks often block traffic between devices.

Do changes I make in QGroundControl stick?

Not if SITL is started with --wipe, which clears its stored parameters on every start. Fly Before saves the parameters you change in QGroundControl after the flight and loads them next time; Back to original settings ignores them.

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