Skip to content

Installing MPF

The current stable version of MPF is 0.57.x.

MPF should work with following platforms:

  • Windows 10 / Windows 11 (64-bit only)
  • macOS 10.14+, up through macOS 14 Sonoma (Intel & Apple Silicon)
  • Linux (64-bit, lots of distros including Debian and Ubuntu)
  • Raspberry Pi

MPF 0.57 works with Python 3.8 - 3.11. It is untested on 3.12, so your mileage may vary.

Regardless of your platform or Python version, a virtual environment is strongly recommended when working with MPF.

Here links to the installation guides for each platform:

Next step: The Tutorial!

We have a tutorial which walks you through the first few steps of getting your project started at missionpinball.org/tutorial


Something missing or wrong? You can fix it!

This website is edited by people like you! Is something wrong or missing? Is something out of date, or can you explain it better?

Please help us! You can fix it yourself and be an official "open source" contributor!

It's easy! See our Beginner's guide to editing the docs.

Page navigation via the keyboard: < >

You can navigate this site via the keyboard. There are two modes:

General navigation, when search is not focused:

  • F , S , / : open search dialog
  • P , , : go to previous page
  • N , . : go to next page

While using the search function:

  • Down , Up : select next / previous result
  • Esc , Tab : close search
  • Enter : go to highlighted page in the results