buildrepo(1)

📦 version 1.3.2, in alpine 3.24

💅 buildrepo — the general commands manual, section 1, bestie 🎀

okay so picture this: you've got an apk repository tree that needs building, and you want it done right. That's buildrepo, and she's the main character of this whole page. She's from the General Commands Manual, section 1, and she's about to make your life so much easier.

✨ NAME ✨

buildrepo — build an apk repository tree 🌈

🦋 SYNOPSIS 🦋

buildrepo [-hknps] [-a DIR] [-d DIR] [-l DIR] [-r REPO] REPO...

💖 DESCRIPTION 💖

So here's the vibe: buildrepo builds an apk repository tree, and the way she does it is genuinely iconic — she takes care to build dependant packages in the correct order. No chaos, no "why did this fail" energy, just correct ordering, periodt. 👑

And the best part? buildrepo shall skip packages that are already up to date. She is not doing unnecessary work, she is not redoing what's already done. Efficiency queen. 💅

🌸 OPTIONS 🌸

  • -a, --aports=DIR — sets the aports base dir to DIR instead of $HOME/aports. That's the default, just so you know 🫶
  • -c, --config=FILE — use FILE as the config instead of /etc/buildrepo/config.lua. Custom config, custom life ✨
  • -d, --destdir=DIR — sets the destination repository base to DIR instead of $HOME/packages. Your packages gotta land somewhere, bestie 🎀
  • -h, --help — shows help and exits. The classic "wait what does this do again" move 😭
  • -l, --logdir=DIR — creates build logs in DIR/REPO/pkgname/ instead of printing them to stdout. Receipts! Filed! Properly! 💖
  • -k, --keep-going — keep going, even if packages fails. Yes, that's the manpage's grammar, and yes, the energy is "we don't stop, we don't fold" 🔥
  • -n, --dry-run — dry run: don't actually build or delete, just print. A little test drive before the real thing, no cap 🙈
  • -p, --purge — purge obsolete packages from REPODIR after build. Clean girl aesthetic applied to your repo 🧹
  • -r, --deps-repo=REPO — dependencies are found in REPO. Gotta know where to look 👀
  • -s, --skip-failed — skip those which previously failed (src dir exists). No retraumatising the failures, we move 🦋
  • -R, --rootbld — build packages in clean chroots. Immaculate, isolated, hygienic chroot vibes ✨

⭐ EXAMPLE ⭐

CBUILD=aarch64 buildrepo -d "$HOME/packages" -a "$(pwd)" -p -R builder

look at her go 😭💜

🌈 SEE ALSO 🌈

abuild(1), APKBUILD(5), apk(8), ap(1) — the whole friend group, go say hi 🫶

👑 AUTHORS 👑

Natanael Copa <ncopa@alpinelinux.org> and other lua-aports authors 💖

okay that's the whole page, bestie — and for the sign-off: this was the buildrepo(1) page, dated 2026-04-13, and it lives under the General Commands Manual. slay, go build something beautiful 💅🎀✨

📦 where this page comes from