karsten13/mmpm repository overview

⁠➡️ You find the source repository here⁠

⁠This repo contains a Docker Setup for

⁠MMPM - The MagicMirror² Package Manager

MMPM is a package manager for the MagicMirror² Project⁠.

For more info visit the Project Website⁠.

⁠Restrictions

❌ Some actions in the Control Center of MMPM are not supported. Functionality which needs access to the host (partially root access) is unwanted from inside a container.

⁠Installation prerequisites

⁠Docker

• Docker⁠
• to run docker commands without needing sudo please refer to the linux postinstall documentation⁠
• as we are using docker compose commands the compose plugin must be installed. If missing you find here⁠ instructions how to install it.

⁠Running MagicMirror²

MagicMirror² must run and the url must be reachable from the machine where mmpm is running.

⁠Running MagicMirror² and MMPM as docker container

It makes sense to run both applications as container, you can use my docker setup for MagicMirror²⁠ for this.

To add MMPM to the MagicMirror² docker setup you have to change one line in the magicmirror/run/.env file:

MM_MMPM="mmpm"

For more info head over to the MagicMirror² Docker Setup Documentation⁠.

⁠Running only MMPM as docker container

Copy the compose.yaml file in a directory of your pi, e.g. ~/mmpm

Adjust the compose.yaml file for your needs (see explanations as comments in the file).

For starting mmpm go into the directory with the compose.yaml file and execute docker compose up -d, for stopping execute docker compose down. You can see the logs with docker logs mmpm.

⁠Installation of MMPM as module in MagicMirror²

While starting the MMPM container it will install MMPM as module in MagicMirror²:

• install MMPM in the MagicMirror² modules folder
• insert a MMPM config section in the MagicMirror² config.js (if not already exists)

⁠Configuration of MMPM

Use a web browser for accessing the application under http://ip_of_your_pi:7890/, e.g. http://192.168.0.11:7890/.

After the first start you may have to update MMPM_MAGICMIRROR_URI, see this wiki⁠ for more information.

If you running both (MagicMirror² and MMPM) as container in the same network you should set "MMPM_MAGICMIRROR_URI": "http://mm:8080", where mm is the container name of MagicMirror² and 8080 the port of MagicMirror² (this is already the default when using the docker setup for MagicMirror²⁠).

⚠️ The active modules page in the control center is not working until you restart both containers after a change of MMPM_MAGICMIRROR_URI. You can do this by running docker compose up -d --force-recreate from inside the ~/magicmirror/run folder.

⚠️ You may have to load MagicMirror² in the browser before loading MMPM-GUI (or refresh MMPM-GUI) to see active modules.