MagicMirror

MagicMirror² is an open source modular smart mirror platform.

  • Home Automation
  • Other
  • Productivity
  • Tools & Utilities
MagicMirror² is an open source modular smart mirror platform. It turns a display behind a two-way mirror, a wall tablet or simply a browser tab into a personal dashboard showing clock, calendar, weather, news and hundreds of community modules. For homelab users, it runs in server-only mode where the interface is served over HTTP and rendered in any browser or on a separate client device such as a Raspberry Pi, the correct fit for a headless Unraid server where the Electron scenario for a locally attached display cannot run.

Platform availability

Available on 3 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

74/100 Good

Maintained
73last commit 51 days ago
Popular
8824,162 GitHub stars
Easy to install
553 install platforms, install notes, Docker image
Light to run
602 GB minimum RAM, runs on ARM
Security check
88no serious findings, 2 minor, CI, tests

Availability: platform listings confirmed today, links checked 14 days ago

GitHub stars
24,162
Open issues
6
Last commit
2026-10-01
Latest release
v2.38.0
License
MIT
Activity
stale

Checked 22 days ago - source: GitHub (MagicMirrorOrg/MagicMirror)

Resources & Compatibility

Minimum requirements: 2 GB RAM. ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install the app's missing pieces Run node --run install-mm inside your MagicMirror folder before the first launch; this downloads required software and can take a long time, and without it the mirror may fail to start. source
  • Start the mirror In the MagicMirror folder, run node --run start, or node --run start:windows on Windows. If your Linux display system is X11 rather than Wayland, use node --run start:x11 so the window appears on the right screen. source
  • Keep your settings safe MagicMirror reads its setup from a JavaScript config file (a small code file that lists your modules). Keep a copy of it, or use the MM_CONFIG_FILE setting to point at another file, so you do not lose your modules or start the mirror with the wrong layout. source
  • First start No setup is required. On first start the image writes a working config.js that listens on all interfaces and already permits the usual private network ranges, including 10.x, 172.16-31.x and 192.168.x. The template runs the container as user 99:100. source

Fetched 37 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How can I run MagicMirror so I can view it in a browser on another device?

Use the server scenario; it starts the server and lets you open the application in your browser of choice.

How can I avoid losing my module setup if the config file is overwritten?

Keep a copy of the JavaScript config file, or use the MM_CONFIG_FILE setting to point at another file.

What should I run before the first launch if MagicMirror fails to start because required software is missing?

Run node --run install-mm inside your MagicMirror folder before the first launch; this downloads the required software and can take a long time.

Which start command should I use on a Linux system that uses X11 instead of Wayland?

Use node --run start:x11 so the window appears on the right screen.

How can I display MagicMirror on a Raspberry Pi screen when another instance is already running?

Use the client scenario, which starts MagicMirror on the Raspberry Pi screen using another running MagicMirror instance.

Answers sourced from docs.magicmirror.builders, docs.magicmirror.builders, khassel.gitlab.io

Community

Collected 53 days ago - public community threads