apk-cache(8) System Manager's Manual apk-cache(8)

apk cache - manage a local cache of package files

apk cache [<options>...] clean

apk cache [<options>...] download [dependency...]

apk cache [<options>...] purge

apk cache [<options>...] sync [dependency...]

Manage local package cache by removing obsolete packages, or downloading missing or newer packages from the repositories.

apk cache download will fetch package files from the repositories and store them in the cache, which must be enabled upfront (see apk-cache(5)). By default world dependencies are used to determine what to download. If dependency arguments are given, they will by default replace the world.

apk cache clean will remove package files which no longer exist in any repository index. Specifying the global option --purge will additionally remove all uninstalled package on tmpfs installations, and all packages on disk installations.

apk cache purge is a synonym for clean --purge.

apk cache sync performs both operations.

--add-dependencies

Add the argument dependencies to world dependencies when determining which packages to download.

-a, --available

Selected packages to be downloaded from active repositories even if it means replacing or downgrading the installed package.

--ignore-conflict

Ignore conflicts when resolving dependencies. This can be useful when pre-populating cache for creation of multiple images in one go.

-l, --latest

Always choose the latest package by version. However, the versions considered are based on the package pinning. Primarily this overrides the default heuristic and will cause an error to displayed if all dependencies cannot be satisfied.

-u, --upgrade

Upgrade packages and it's dependencies. Normally apk add will avoid changing installed package unless it is required by the newly added packages or their dependencies. This changes the default preference to upgrading the package to the latest installable version.

-s, --simulate

Simulate the requested operation without making any changes.
2024-04-29