docs: fix migration guidance for old console script and orphaned container

2026-07-27 18:36:42 -07:00
parent d2b7986cb9
commit 6c15c3d8f1
1 changed files with 6 additions and 2 deletions
@@ -43,11 +43,15 @@ Config is TOML. Resolution order:
 If you used this project under its former name, move your existing config once:

 ```sh
+pip uninstall karaoke-maker    # removes the old console script
 mv ~/.config/karaoke-maker ~/.config/songtrace
 ```

-The Docker deployment needs no migration — the image sets `SONGTRACE_CONFIG`
-itself and the config is bind-mounted to a fixed path.
+The Docker deployment needs no config migration — the image sets
+`SONGTRACE_CONFIG` itself and the config is bind-mounted to a fixed path.
+Run `docker compose down` before upgrading (or `docker compose up -d
+--remove-orphans`) since the service key changed and Compose won't replace
+the old container in place.

 Copy the example and fill in your Whisper server: