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 is distributed as a Python package (see PyPI). A number of pre-requisite packages are required to run MAVProxy, as detailed in the individual sections below.
A complete windows installer (package) for MAVProxy is available at
http://firmware.ardupilot.org/Tools/MAVProxy/. The latest version is:
MAVProxySetup-latest.exe. It is compatible
with Windows 7 or later.
A link to MAVProxy will be available on the start menu. MAVProxy can also be called from the commandline via mavproxy.exe
Any references to “mavproxy.py” in this documentation should be replaced by “mavproxy.exe” on the Windows commandline.
Alternatively, Windows 10 users can use the Windows Subsystem for Linux (WSL) to run MAVProxy from a Linux environment within Windows. It generally provides better stability than the native Windows installer above.
For Debian based systems (including Ubuntu, WSL, Raspian):
sudo apt-get install python3-dev python3-opencv python3-wxgtk4.0 python3-pip python3-matplotlib python3-lxml python3-pygame pip3 install PyYAML mavproxy --user echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.bashrc
For Fedora based systems:
sudo dnf install python3-devel python3-opencv python3-wxpython4 python3-pip python3-matplotlib python3-pygame python3-lxml python3-yaml redhat-rpm-config pip3 install PyYAML mavproxy --user echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.bashrc
If you get a “permission denied” error message when connecting to serial devices, the user permissions may need to be changed:
sudo usermod -a -G dialout <username>
The system will need to be restarted to apply the above change.
To update an existing installation with the current release:
pip3 install mavproxy pymavlink --user --upgrade
To update an existing installation with the current development version (ie, from its master branch):
pip3 install mavproxy --user git+https://github.com/ArduPilot/mavproxy.git@master
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 pip3 uninstall python-dateutil
Install MAVProxy and its remaining dependencies from the public PyPi repository:
sudo pip3 install wxPython sudo pip3 install gnureadline sudo pip3 install billiard sudo pip3 install numpy pyparsing sudo pip3 install MAVProxy