Setting up a development install

System requirements

SSH-MITM is developed on Linux, but should also run on MaxOS or Windows.

While it should run on other operating systems most advanced features are only supported on Linux.

If you are using Windows, we recommend using VirtualBox or a similar system to run Ubuntu Linux for development.

Install Python

SSH-MITM is written in the Python programming language, and requires you have at least version 3.8 installed locally. If you haven’t installed Python before, the recommended way to install it is to use your systems package manager. Remember to get the ‘Python 3’ version, and not the ‘Python 2’ version!

Install git

SSH-MITM uses git & GitHub for development & collaboration. You need to install git to work on SSH-MITM. We also recommend getting a free account on

Setting up a development install

When developing SSH-MITM, you need to make changes to the code & see their effects quickly. You need to do a developer install to make that happen.


This guide does not attempt to dictate how development environments should be isolated since that is a personal preference and can be achieved in many ways, for example tox, conda, docker, etc.

  1. Clone the SSH-MITM git repository to your computer.

    git clone
    cd ssh-mitm
  2. Make sure the python you installed is available to you on the command line.

    python -V

    This should return a version number greater than or equal to 3.8.

  3. Install the development version of SSH-MITM. This lets you edit SSH-MITM code in a text editor & restart the SSH-MITM process to see your code changes immediately.

    python3 -m pip install --editable .
  4. You are now ready to start SSH-MITM!

    ssh-mitm server
  5. Access SSH-MITM from your local ssh client:

    ssh -P 10022 localhost

Happy developing!