docs: Windows deploy order (quit before install) to avoid pywin32 lock

This commit is contained in:
2026-06-22 16:52:50 +02:00
parent 04ffaa457b
commit 34327520b6
+11 -2
View File
@@ -22,10 +22,19 @@ containers, images, compose files, networks, and system housekeeping.
``` ```
1. Claude Code commits and pushes 1. Claude Code commits and pushes
2. uv tool install --reinstall git+<repo-url> 2. Fully quit Claude Desktop (tray icon → Quit) so the running MCP server
3. Restart Claude Desktop (tray icon → Quit → relaunch) releases its file locks
3. uv tool install --reinstall git+<repo-url>
4. Relaunch Claude Desktop
``` ```
**Windows lock gotcha — quit BEFORE install:** on Windows the running MCP
server holds `pywin32` files open, so `uv tool install --reinstall` fails
mid-swap (`os error 32: used by another process`) and leaves the tool env
incomplete (the old packages are already uninstalled). The order above
(quit → install → relaunch) avoids this — never reinstall while Claude Desktop
is still running.
**Push retry:** the Gitea remote (`gitea.gecheckt.de`) occasionally **Push retry:** the Gitea remote (`gitea.gecheckt.de`) occasionally
returns `Unauthorized` on the first push attempt. If `git push` fails returns `Unauthorized` on the first push attempt. If `git push` fails
with an auth error, wait 1 s and retry once before reporting back. with an auth error, wait 1 s and retry once before reporting back.