Files
PX4-Autopilot/docs/en/simulation/px4_simulation_quickstart.md
Hamish Willee 96e760a782 docs(docs): Fix almost all broken external links (#27790)
* docs(docs): Add missing uorb topics sidebar
* docs(docs): discontinue cuav v5 plus/nano
* docs(docs): Fix 404 and 303 status HTTP links
* docs(docs): more link fixes
* update(drivers): Docs fix to fix up link
* docs(docs): Fix up all remaining  broken links and add exclusions
2026-07-02 16:58:40 +10:00

1.6 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 (on Linux, macOS, and Windows):

docker run --rm -it -p 14550:14550/udp px4io/px4-sitl:latest

That's it — open QGroundControl and fly!

::: details Trouble connecting to QGC? This command is recommended for Linux and can also be used on Windows (with recent docker/WSL2). It uses a different mechanism for connecting to the host ports, and will often work in rare cases where the other command does not.

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

:::

::: tip

To try other vehicle types, use the -e flag to pass the PX4_SIM_MODEL environment variable to the docker run command:

Plane

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

Standard VTOL

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

Ackermann rover

docker run --rm -it -p 14550:14550/udp -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.

:::