Download and Installation

The following instructions are for user that just want to run MAVProxy. Developers should look at the Developer’s Guide for setting up the development environment.


A complete windows installer for MAVProxy is available at


Please note that the “missionedit” module does not currently run on the Windows package of MAVProxy. This is being investigated and will hopefully be fixed soon. See for more details.


First, a few pre-requisite packages need to be installed.

For Debian based systems:

sudo apt-get install python3-dev python3-opencv python3-wxgtk3.0 python3-pip python3-matplotlib python3-pygame python3-lxml python3-yaml

For Fedora based systems:

sudo dnf install python3-devel python3-opencv wxPython python3-pip python3-matplotlib pygame python3-lxml python3-yaml redhat-rpm-config


On some older Linux systems, python-wxgtk3.0 may be instead named as python-wxgtk2.8.


On Raspberry Pi (Raspian) systems, the libxml2-dev package is required to be installed too.

Then download and install MAVProxy via Pypi. Prerequisites will be automatically downloaded too. Note a sudo may be required in some circumstances if the install generates errors:

pip install MAVProxy

Depending on user and system settings, there may be some extra configuration required.

If not already set, MAVProxy needs to be on the system path:

echo "export PATH=$PATH:$HOME/.local/bin" >> ~/.bashrc

The user permissions may also need to be changed to allow access to serial devices:

sudo adduser <username> dialout

The system will need to be logged out and logged back in again to apply the above two changes.


Install Python via

brew install python --framework

Uninstall python-dateutil (OSX and Windows come bundled with a version that is not supported for some dependencies):

sudo pip uninstall python-dateutil

Install MAVProxy and its remaining dependencies from the public PyPi repository:

sudo pip install wxPython
sudo pip install gnureadline
sudo pip install billiard
sudo pip install numpy pyparsing
sudo pip install MAVProxy