docs: add migration guide from RPi-Monitor to PiMonitor#84
Merged
LarsLaskowski merged 3 commits intoJul 17, 2026
Conversation
Users switching from RPi-Monitor need to fully remove the old service, package, and its leftover cron jobs/config before running PiMonitor side by side is safe. Document the steps (stop/disable/purge the service, clean up cron and systemd leftovers, optional web server config cleanup) so this doesn't have to be re-derived per user.
Recommending "install PiMonitor first, remove RPi-Monitor after" breaks if the user reuses RPi-Monitor's old port for PiMonitor's listen_addr: RPi-Monitor's lighttpd would still hold that port, so pimonitor.service fails to bind and crash-loops. Clarify that RPi-Monitor must be stopped first in that case, with default ports being the only case where order doesn't matter.
Updated the RPi-Monitor link and adjusted text for clarity.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a comprehensive migration guide to the README for users replacing RPi-Monitor with PiMonitor on the same device. The guide covers:
lighttpd)This addresses a real operational concern: if users don't stop RPi-Monitor's
lighttpdbefore starting PiMonitor on the same port, the systemd service will fail to bind and crash-loop.Related Issue
Checklist
README.md)