Files
PX4-Autopilot/docs/en/simulation/px4_simulation_quickstart.md
Anshaj KumarandHamish Willee 424aaceee7 docs(simulation): fix Docker networking in QuickStart (#29330)
* docs(simulation): fix Docker networking in QuickStart

Assisted-by: Codex:ChatGPT

* docs(simulation): explain dropping -p and add Linux quickstart command

Say why UDP 14550 must not be published on Docker Desktop: Docker then
holds the host port and QGroundControl can't bind it. Give Linux and
WSL2 readers a ready-made --network host command, restore the WSL2
guidance the removed details block carried, and fix the tip's lead-in
colon pointing at the Linux note instead of the commands.

Assisted-by: Claude:claude-opus-5-5
Signed-off-by: Hamish Willee <hamishwillee@gmail.com>

* docs(sim): reduce complication_

---------

Signed-off-by: Hamish Willee <hamishwillee@gmail.com>
Co-authored-by: Hamish Willee <hamishwillee@gmail.com>
2026-10-21 21:05:05 +11:00

1.3 KiB

PX4 Simulation QuickStart

First install Docker (a free tool that runs containers).

The following command will then run a PX4 quadrotor simulation that you can connect to QGroundControl, MAVSDK or ROS 2.

docker run --rm -it px4io/px4-sitl:latest

On Linux (or WSL2 without Docker Desktop):

docker run --rm -it --network host px4io/px4-sitl:latest

That's it — open QGroundControl and fly!

::: tip

To try other vehicle types, use the -e flag to pass the PX4_SIM_MODEL environment variable to the docker run command (on Linux, or WSL2 without Docker Desktop, also add --network host):

Plane

docker run --rm -it -e PX4_SIM_MODEL=sihsim_airplane px4io/px4-sitl:latest

Standard VTOL

docker run --rm -it -e PX4_SIM_MODEL=sihsim_standard_vtol px4io/px4-sitl:latest

Ackermann rover

docker run --rm -it -e PX4_SIM_MODEL=sihsim_rover_ackermann px4io/px4-sitl:latest

For more information and options see Container Images (in Pre-built SITL Packages) and SIH Simulation.

:::