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

# [NAME](#NAME)

apk index - create repository index file from packages

# [SYNOPSIS](#SYNOPSIS)

**apk index** \[<*options*>...] *packages*...

# [DESCRIPTION](#DESCRIPTION)

**apk index** creates a repository index from a list of package files. See [**apk-repositories**(8)](/man/os/apk-tools/apk-repositories.8) for more information on repository indicies.

Generally, the resulting index must be cryptographically signed before **apk** will accept it. See [**abuild-sign**(1)](/man/os/apk-tools/abuild-sign.1) for details.

# [OPTIONS](#OPTIONS)

**-d, --description** *TEXT*

Add a description to the index. Upstream, this is used to add version information based on the git commit SHA of aports HEAD at the time of index generation.

**--merge**

Merge *packages* into the existing *INDEX*.

**-o, --output** *FILE*

Output generated index to *FILE*.

**--prune-origin**

Prune packages from the existing *INDEX* with same origin as any of the new *packages* during merge.

**-x, --index** *INDEX*

Read an existing index from *INDEX* to speed up the creation of the new index by reusing data when possible.

**--no-warnings**

Disable the warning about missing dependencies. This happens when A, depends on package B, that does not have a provider in the indexed repository.

**--rewrite-arch** *ARCH*

Set all package's architecture to *ARCH*.

# [ENVIRONMENT](#ENVIRONMENT)

**SOURCE\_DATE\_EPOCH**

Used as the build time for tar file headers in APKINDEX.tar.gz.

2026-10-27

---

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