MagicMirror² DocsMagicMirror² Docs
Donate
Discord
Forum
GitHub
Donate
Discord
Forum
GitHub
  • Getting Started

    • Introduction
    • Requirements
    • Installation & Usage
    • Upgrade Guide
  • Configuration

    • Introduction
    • Autostart your MagicMirror²
    • Raspberry Specific
  • Modules

    • Introduction
    • Module Configuration
    • Default Modules

      • Alert
      • Calendar
      • Clock
      • Compliments
      • Hello World
      • News Feed
      • Update Notification
      • Weather Module
    • Animation Guide
  • Module Development

    • Introduction
    • The Core module file
    • The Node Helper
    • MagicMirror Helper Methods
    • Logger
    • Notifications
    • Weather Module Weather Provider Development
    • How to write good documentation
  • About

    • MagicMirror² Manifesto
    • Contributing Guidelines
    • Donate
    • Support
    • License

Requirements

Hardware

MagicMirror² is developed to run on a Raspberry Pi. It might (and will) run on various different types of hardware, but new versions will only be tested on a Raspberry Pi.

Electron, the app wrapper around MagicMirror², only supports the Raspberry Pi 2, 3, 4 & 5. The Raspberry Pi 0/1 is currently not supported. If you want to run this on a Raspberry Pi 1, use the server only feature and setup a fullscreen browser yourself. (Yes, people have managed to run MM² also on a Pi0, so if you insist, search in the forums.)

Operating System

You will need to install the latest full version of Raspberry Pi OS (previously called Raspbian).

If you want to run the software on other Operating Systems, take a look at this section

NOTE You do need a desktop environment to run Electron!

Using a Lite Version of Raspberry Pi OS will not work.

Raspberry Pi OS versions based on Debian "Buster" are also no longer supported.

Node

Please refer to the release page to see which node version is required.

Help us improve this page!
Last Updated:: 4/30/25, 8:00 PM
Prev
Introduction
Next
Installation & Usage