fb2aa438d8
Having repeatedly seen that users are unaware of the meaning of the EADDRINUSE error message (see, for example, this [forum thread](https://forum.magicmirror.builders/topic/19871/update-package-list/5)), I thought we should intercept this message and provide clearer output. This may help users identify the cause of the problem more quickly themselves. ## before ``` [2025-09-13 09:54:32.903] [LOG] Starting MagicMirror: v2.33.0-develop ... [2025-09-13 09:54:33.533] [LOG] Starting server on port 8080 ... [2025-09-13 09:54:33.537] [WARN] You're using a full whitelist configuration to allow for all IPs [2025-09-13 09:54:33.568] [ERROR] Whoops! There was an uncaught exception... [2025-09-13 09:54:33.574] [ERROR] Error: listen EADDRINUSE: address already in use 0.0.0.0:8080 at Server.setupListenHandle [as _listen2] (node:net:1940:16) at listenInCluster (node:net:1997:12) at node:net:2206:7 at process.processTicksAndRejections (node:internal/process/task_queues:90:21) { code: 'EADDRINUSE', errno: -98, syscall: 'listen', address: '0.0.0.0', port: 8080 } [2025-09-13 09:54:33.574] [ERROR] MagicMirror² will not quit, but it might be a good idea to check why this happened. Maybe no internet connection? [2025-09-13 09:54:33.574] [ERROR] If you think this really is an issue, please open an issue on GitHub: https://github.com/MagicMirrorOrg/MagicMirror/issues [2025-09-13 09:54:35.235] [INFO] #### System Information #### ... ``` ## after ``` [2025-09-13 09:53:20.151] [LOG] Starting MagicMirror: v2.33.0-develop ... [2025-09-13 09:53:20.928] [LOG] Starting server on port 8080 ... [2025-09-13 09:53:20.931] [WARN] You're using a full whitelist configuration to allow for all IPs [2025-09-13 09:53:20.970] [ERROR] ──────────────────────────────────────────────────────────────── PORT IN USE: 0.0.0.0:8080 Another process (most likely another MagicMirror instance) is already using this port. Stop the other process (free the port) or use a different port. ──────────────────────────────────────────────────────────────── [2025-09-13 09:53:22.471] [INFO] #### System Information #### ... ```
MagicMirror² is an open source modular smart mirror platform. With a growing list of installable modules, the MagicMirror² allows you to convert your hallway or bathroom mirror into your personal assistant. MagicMirror² is built by the creator of the original MagicMirror with the incredible help of a growing community of contributors.
MagicMirror² focuses on a modular plugin system and uses Electron as an application wrapper. So no more web server or browser installs necessary!
Documentation
For the full documentation including installation instructions, please visit our dedicated documentation website: https://docs.magicmirror.builders.
Links
- Website: https://magicmirror.builders
- Documentation: https://docs.magicmirror.builders
- Forum: https://forum.magicmirror.builders
- Technical discussions: https://forum.magicmirror.builders/category/11/core-system
- Discord: https://discord.gg/J5BAtvx
- Blog: https://michaelteeuw.nl/tagged/magicmirror
- Donations: https://magicmirror.builders/#donate
Contributing Guidelines
Contributions of all kinds are welcome, not only in the form of code but also with regards to
- bug reports
- documentation
- translations
For the full contribution guidelines, check out: https://docs.magicmirror.builders/about/contributing.html
Enjoying MagicMirror? Consider a donation!
MagicMirror² is Open Source and free. That doesn't mean we don't need any money.
Please consider a donation to help us cover the ongoing costs like webservers and email services. If we receive enough donations we might even be able to free up some working hours and spend some extra time improving the MagicMirror² core.
To donate, please follow this link.
