---
name: "apk-list"
section: "8"
platform: "linux"
package: "apk-tools"
version: "3.0.8-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/apk-list"
---

# apk-list(8)

list packages matching a pattern or other criteria

## NAME

apk list - list packages matching a pattern or other criteria

## SYNOPSIS

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

## DESCRIPTION

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

The patterns are matched with [**fnmatch**(3)](/fnmatch/3.md), which behaves similarly to shell globbing.

## OPTIONS

In addition to the global options (see [**apk**(8)](/apk/8.md)), and query options (see [**apk-query**(8)](/apk-query/8.md)) the following options are supported:

- **--available**, **-a**

  Consider only available packages.

- **--depends**, **-d**

  List packages by dependency.

- **--installed**, **-I**

  Consider only installed packages.

- **--manifest**

  List installed packages in format \`\<name\> \<version\>\`.

- **--origin**, **-o**

  List packages by origin.

- **--orphaned**, **-O**

  Consider only orphaned packages.

- **--providers**, **-P**

  List packages by provider.

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

  Consider only upgradable packages.