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.


MAVProxy runs on the Python 2.7.x environment. Ensure your system is running the correct version of Python.


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 python-dev python-opencv python-wxgtk3.0 python-pip python-matplotlib python-pygame python-lxml python-yaml

For Fedora based systems:

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


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


Fedora-based systems cannot run MAVProxy 1.5.7 or earlier, due to a bug in calling OpenCV.


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