Skip to content

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.

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

On Linux (or WSL2 without Docker Desktop):

sh
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

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

Standard VTOL

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

Ackermann rover

sh
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.