A utility to quickly set up complex MongoDB test environments on a local machine
Project description
mrun, is a utility to quickly set up complex MongoDB test environments on a local machine, including replica sets and sharded clusters. It was originally part of the now deprecated mtools collection; however, is now available as a standalone tool.
For more information, see the mongorun documentation.
Requirements and Installation Instructions
mrun is written in Python. The tools are currently tested with Python 3.8, 3.9, 3.10, and 3.11.
mongorun requires pymongo, psutil and packaging dependencies. See the installation instructions for more information.
mongorun is only tested with actively supported (non End-of-Life) versions of the MongoDB server. As of November 2025, that includes MongoDB 7.0 or newer.
Using mongorun
After installing mongorun, you can run it from the command line by typing mrun. For a list of available commands, run:
mrun --help
For detailed usage instructions, see the mongorun documentation.
Recent Changes
See the changelog for a list of changes from previous versions of mlaunch/mongorun.
Contribute to mongrun
If you’d like to contribute to mongorun, please read the contributor page for instructions.
Disclaimer
This software is not supported by MongoDB, Inc. under any of their commercial support subscriptions or otherwise. Any usage of mongorun is at your own risk. Bug reports, feature requests and questions can be posted in the Issues section on GitHub.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mongorun-1.8.0.tar.gz.
File metadata
- Download URL: mongorun-1.8.0.tar.gz
- Upload date:
- Size: 30.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5bf69888a624c720fe2db5bb3fed140bf331f087d2da41da8347dbe7ca7e88dc
|
|
| MD5 |
fb9e66e42b624a04bf9dd53e4bd1399d
|
|
| BLAKE2b-256 |
0af16eb1d9c622430240ac4b07c5cc56a1128f86e5aa87e879d55d903365c2b2
|
File details
Details for the file mongorun-1.8.0-py3-none-any.whl.
File metadata
- Download URL: mongorun-1.8.0-py3-none-any.whl
- Upload date:
- Size: 29.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
eb88d16f6eafcdfc53149c037e09e774f51b8dcfa9680d358f8c5c765b8ff629
|
|
| MD5 |
71d95398ed1d3211674588967d64841c
|
|
| BLAKE2b-256 |
63979b25d8b7115fd677e0eb6f90b3e43128ea4fe5ef173bc232a4dfb944e95d
|