Repository navigation
Home
Brandon Marlowe edited this page Aug 16, 2026
·
8 revisions
MMPM is a command line and web-based package manager for MagicMirror. Modeled after apt, it simplifies installing, removing, upgrading, and managing MagicMirror packages — plus controlling MagicMirror itself — from either a CLI or a browser-based UI.
- Search, install, remove, and upgrade MagicMirror packages from the command line or web UI
- Version pinning and rollback via
mmpm.lock(mmpm rollback,mmpm sync) - Add private or unlisted packages to your local database as Custom Packages
- Install, start, stop, and restart MagicMirror (supports
pm2anddocker-compose) - Hide and show MagicMirror modules on the fly
- Live log streaming, database inspection, and a built-in
doctorcommand for diagnostics - Tab completion for your shell
- Install MMPM: see the Installation page
-
Run the guided setup:
mmpm guided-setupwalks you through configuring MMPM and installing the UI -
Refresh the package database:
mmpm update -
Install something:
mmpm add MMM-mmpm
For a quick reference of every subcommand (and their aliases), see CLI Commands.
| Page | Description |
|---|---|
| CLI Commands | Reference for all mmpm subcommands and aliases |
| Environment Variables | Configuring MMPM via mmpm-env.json
|
| Custom Packages | Adding private or unlisted packages to your database |
| Tab Completion | Enabling shell autocompletion for mmpm
|
- Run
mmpm <subcommand> --helpfor details on any command - Run
mmpm doctorto diagnose common installation and configuration problems - File bugs and feature requests on the issue tracker