Technical reference
Architecture, services, paths, local admin port and safe diagnostic commands for MuPiBox NG.
For Linux administrators; actual services and files vary by release.
Architecture and paths
MuPiBox NG uses a Go backend, touch UI, system agent and audio/provider services.
| Path or address | Purpose |
|---|---|
http://<box-ip>:8090/admin/ | Local administration |
/srv/mupibox/music | Local media |
/var/lib/mupibox-ng/backups/ | Update backups |
/etc/mupibox-ng/ | System configuration |
/opt/mupibox-release/current/ | Current release files on supported installations |
Typical services
mupibox-ng (backend), mupibox-ui (touch), mupibox-system-agent (privileged actions), mupibox-wireplumber and mupibox-pipewire (audio), mupibox-audio-bus (shared bus), mupibox-splash (boot image). Not every unit runs in every profile.
Read-only diagnosis
systemctl --failed systemctl status mupibox-ng mupibox-ui --no-pager journalctl -u mupibox-ng -b --no-pager -n 100 systemd-analyze blame
Prefer browser logs when possible. Treat backups and API tokens as confidential. Do not expose the admin port directly to the Internet.