diff --git a/CLAUDE.md b/CLAUDE.md index e6b1cbe..cf99292 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -138,7 +138,7 @@ CLI available as `cf` or `compose-farm`. | `stop` | Stop services without removing containers (`docker compose stop`) | | `pull` | Pull latest images | | `restart` | `down` + `up -d` | -| `update` | `pull` + `build` + `down` + `up -d` | +| `update` | Pull, build, recreate only if changed (`up -d --pull always --build`) | | `apply` | Make reality match config: migrate stacks + stop orphans. Use `--dry-run` to preview | | `compose` | Run any docker compose command on a stack (passthrough) | | `logs` | Show stack logs | diff --git a/README.md b/README.md index a6e0a8e..e8596f9 100644 --- a/README.md +++ b/README.md @@ -370,7 +370,7 @@ The CLI is available as both `compose-farm` and the shorter `cf` alias. | `cf down ` | Stop and remove stack containers | | `cf stop ` | Stop stack without removing containers | | `cf restart ` | down + up | -| `cf update ` | pull + build + down + up | +| `cf update ` | Pull, build, recreate only if changed | | `cf pull ` | Pull latest images | | `cf logs -f ` | Follow logs | | `cf ps` | Show status of all stacks | @@ -403,7 +403,7 @@ cf pull --all # Restart (down + up) cf restart plex -# Update (pull + build + down + up) - the end-to-end update command +# Update (pull + build, only recreates containers if images changed) cf update --all # Update state from reality (discovers running stacks + captures digests) @@ -475,8 +475,7 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a │ pull Pull latest images (docker compose pull). │ │ restart Restart stacks (down + up). With --service, restarts just │ │ that service. │ -│ update Update stacks (pull + build + down + up). With --service, │ -│ updates just that service. │ +│ update Update stacks. Only recreates containers if images changed. │ │ apply Make reality match config (start, migrate, stop │ │ strays/orphans as needed). │ │ compose Run any docker compose command on a stack. │ @@ -694,8 +693,7 @@ Full `--help` output for each command. See the [Usage](#usage) table above for a Usage: cf update [OPTIONS] [STACKS]... - Update stacks (pull + build + down + up). With --service, updates just that - service. + Update stacks. Only recreates containers if images changed. ╭─ Arguments ──────────────────────────────────────────────────────────────────╮ │ stacks [STACKS]... Stacks to operate on │ diff --git a/docs/commands.md b/docs/commands.md index a562d16..9e907ee 100644 --- a/docs/commands.md +++ b/docs/commands.md @@ -15,7 +15,7 @@ The Compose Farm CLI is available as both `compose-farm` and the shorter alias ` | | `down` | Stop stacks | | | `stop` | Stop services without removing containers | | | `restart` | Restart stacks (down + up) | -| | `update` | Update stacks (pull + build + down + up) | +| | `update` | Update stacks (only recreates if images changed) | | | `pull` | Pull latest images | | | `compose` | Run any docker compose command | | **Monitoring** | `ps` | Show stack status | @@ -225,7 +225,7 @@ cf restart immich --service database ### cf update -Update stacks (pull + build + down + up). With `--service`, updates just that service. +Update stacks. Only recreates containers if images changed. With `--service`, updates just that service.