The mtools collection is written in Python, and most of the tools only use the standard packages shipped with Python. The tools are currently tested with Python 2.7 and 3.6.
Some of the tools have additional dependencies, which are listed under the specific tool’s section.
The mtools utilities are only tested with currently supported (non End-of-Life) versions of the MongoDB server. As of April 2018, that includes MongoDB 3.2 or newer.
You need to have Python 2.7.x or 3.6.x installed in order to use mtools. Other versions of Python are not currently supported.
To check your Python version, run
python --versionon the command line.
Installation with pip#
The easiest way to install mtools is via
pip. From the command line, run:
pip install mtools
You need to have
pip installed for this to work. If you don’t have
installed yet, try
sudo easy_install pip from the command line first, or
follow the instructions provided on the pip installation page.
Depending on your user rights,
pip may complain about not having
permissions to install into the system directory.
In that case, you either need to add
sudo in front of the
to install into a system directory, or append
--user to install into your
Some mtools scripts have additional Dependencies.
Installation from source#
pip is not available and you want to install mtools from source, you can
get the source code by cloning the mtools github repository:
git clone git://github.com/rueckstiess/mtools.git
Or download the tarball from PyPI and extract it with:
tar xzvf mtools-<version>.tar.gz
cd into the mtools directory and run:
sudo python setup.py install
This will install mtools into your Python’s site-packages folder, create links to the scripts and set everything up. You should now be able to use all the scripts directly from the command line.
The full list of requirements (some of which are already included in the Python standard library) can be found in the requirements.txt file.
To install all dependencies for full feature support, run:
pip install mtools[all]
To install dependencies for a subset of mtools utilities, specify one or more script names as a comma-separated list:
pip install mtools[mlaunch,mloginfo]
required for mlaunch
psutil to manage starting, stopping, and finding MongoDB
required for mlaunch
pymongo is MongoDB’s official
mlaunch uses this to configure and query local MongoDB
required for mplotqueries
matplotlib is a python 2D plotting library which produces figures and graphs in a variety of formats and interactive environments across platforms.