diff --git a/docs/install.md b/docs/install.md index be66d9c..98699c1 100644 --- a/docs/install.md +++ b/docs/install.md @@ -1064,7 +1064,12 @@ A replica may come back marked **`ready (stale profile)`**. That means it is running a profile that has since been edited — the reconciler leaves a serving replica alone on purpose, because churning one costs more than the difference. `llmgw ctl restart ` replaces it with one on the new profile, starting -the new one before stopping the old. +the new one before stopping the old. Where the old one is all that stands in +the new one's way — a single GPU — it is stopped first, at once, and the model +is unserved while the new one loads; where the new profile fits nowhere even +then, the restart is refused and the old one keeps serving, which `ctl +replicas` shows as `restart refused:` with the reason. `--in-place` asks for +stop-then-start whatever room there is. ### Signed releases