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

# [NAME](#NAME)

apk list - list packages matching a pattern or other criteria

# [SYNOPSIS](#SYNOPSIS)

**apk list** \[<*options*>...] *pattern*...

# [DESCRIPTION](#DESCRIPTION)

**apk list** searches package indicies for packages matching the given patterns and prints any matching packages.

The patterns are matched with [**fnmatch**(3)](/man/os/apk-tools/fnmatch.3), which behaves similarly to shell globbing.

# [OPTIONS](#OPTIONS)

**-I, --installed**

Consider only installed packages.

**-O, --orphaned**

Consider only orphaned packages.

**-a, --available**

Consider only available packages.

**-u, --upgradable, --upgradeable**

Consider only upgradable packages.

**-o, --origin**

List packages by origin.

**-d, --depends**

List packages by dependency.

**-P, --providers**

List packages by provider.

2026-10-27

---

Document: apk-list(8) from apk-tools 2.14.12-r0 (Chainguard OS)
Source: https://gitlab.alpinelinux.org/alpine/apk-tools.git