Skip to content

docs: fix pull --policy value from newer to ifnewer #6994

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
locker95 wants to merge 4 commits into from
Closed

docs: fix pull --policy value from newer to ifnewer #6994

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
a021207
docs: fix pull --policy value from newer to ifnewer
locker95 Jul 25, 2026
4ec35ce
chore: re-trigger Packit after COPR base repo timeout
locker95 Jul 25, 2026
2b7a726
chore: re-trigger Packit COPR builds
locker95 Jul 27, 2026
d01896f
docs: note ifnewer is equivalent to podman pull --policy=newer
locker95 Jul 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions docs/buildah-pull.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -70,14 +70,15 @@ and can also be found by running `go tool dist list`.

**NOTE:** The `--platform` option may not be used in combination with the `--arch`, `--os`, or `--variant` options.

**--policy**=**always**|**missing**|**never**|**newer**
**--policy**=**always**|**missing**|**never**|**ifnewer**

Pull image policy. The default is **missing**.
These values match the pull policies used by **podman pull** (see **podman-pull(1)**); the policy that podman documents as **newer** is the same behavior as **ifnewer** here.

- **always**: Always pull the image and throw an error if the pull fails.
- **missing**: Pull the image only if it could not be found in the local containers storage. Throw an error if no image could be found and the pull fails.
- **never**: Never pull the image but use the one from the local containers storage. Throw an error if no image could be found.
- **newer**: Pull if the image on the registry is newer than the one in the local containers storage. An image is considered to be newer when the digests are different. Comparing the time stamps is prone to errors. Pull errors are suppressed if a local image was found.
- **ifnewer**: Pull if the image on the registry is newer than the one in the local containers storage. An image is considered to be newer when the digests are different. Comparing the time stamps is prone to errors. Pull errors are suppressed if a local image was found. Equivalent to **podman pull --policy=newer**.

**--quiet**, **-q**

Expand Down