---
name: "apk-index"
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-index"
---

# apk-index(8)

create repository index file from packages

## NAME

apk index - create repository index file from packages

## SYNOPSIS

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

## DESCRIPTION

**apk index** creates a repository index from a list of package files. See [**apk-repositories**(5)](/apk-repositories/5.md) for more information on repository indices.

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

## OPTIONS

- **--description**, **-d** *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.

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

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

- **--merge**

  Merge *packages* into the existing *INDEX*.

- **--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.

- **--output**, **-o** *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.

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

  Set all package's architecture to *ARCH*.

## ENVIRONMENT

**SOURCE\_DATE\_EPOCH**

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