apk-index(8)

📦
version 3.0.9 · 8 versions
, in arch rolling

💖 apk-index(8) — your fave little index-maker, bestie 💖

okay so picture this: it's page apk-index(8) from the System Manager's Manual, and it's literally all about building repository index files. group-chat approved. let's gooo 🫶

✨ NAME ✨

apk index — create a repository index file from packages 🎀

🌸 SYNOPSIS 🌸

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

🦋 DESCRIPTION 🦋

apk index creates a repository index from a list of package files, no cap. if you wanna know more about what a repository index even is, go peek at apk-repositories(5) — it's giving essential reading. 📚

okay here's the part where you gotta pay attention, bestie: generally, the resulting index must be cryptographically signed before apk will accept it. like, it's non-negotiable. see abuild-sign(1) for the details on that. 🔐✨

💅 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. so like, receipts of exactly when you built it. 🧾
  • --index, -x INDEX — read an existing index from INDEX to speed up the creation of the new index by reusing data when possible. lowkey a glow-up for your build times. ⚡
  • --merge — merge packages into the existing INDEX. combining vibes. 🫶
  • --no-warnings — disable the warning about missing dependencies. that warning happens when A depends on package B, and B doesn't have a provider in the indexed repository. so if you're tired of being told, this is your mute button. 🔇
  • --output, -o FILE — output the generated index to FILE. put it somewhere cute. 📁
  • --prune-origin — prune packages from the existing INDEX with the same origin as any of the new packages during merge. out with the old, periodt. ✂️
  • --rewrite-arch ARCH — set all packages' architecture to ARCH. one arch to rule them all. 👑

🌈 ENVIRONMENT 🌈

  • SOURCE_DATE_EPOCH — used as the build time for tar file headers in APKINDEX.tar.gz. reproducible-builds girlies stay winning fr fr. ⏰
heads up bestie: stack those options in whatever order, but packages... always comes at the end. and seriously — sign your index before apk will even look at it. 😭

and that's the whole page, mwah 💋 — this cutie was brought to you by the System Manager's Manual, dated 2026-11-02. slay, go build your index 💖🎀🦋

📦 where this page comes from