mkarchiso(1)

📦 version 92, in arch rolling

✨ NAME ✨

okay so mkarchiso is literally the Arch Linux ISO generator — she makes the whole ISO situation happen, fr fr. This is mkarchiso(1) from the General Commands Manual, and we're about to make it make sense, bestie 💖.

🌈 SYNOPSIS 🌈

mkarchiso [options] profile_directory

🦋 DESCRIPTION 🦋

mkarchiso creates an ISO, netboot artifacts and a bootstrap tarball, and optionally signs them. It's giving full build-girlie main character energy, no cap ✨.

Note: running as a regular (non-root) user requires unshare(1) and user namespace support in the kernel. So if your kernel isn't set up for user namespaces, regular-user mode is not gonna slay — periodt.

💅 OPTIONS 💅

  • -A application — sets an application name for the ISO. Default: 'mkarchiso iso'. Cute name, iconic ISO 🎀.
  • -C file — this is the pacman configuration file. Default: /etc/pacman.conf. pacman stays fed, lowkey 🍓.
  • -D install_dir — sets an install_dir. All files will be located here. Default: arch.
Note: for iso and netboot, use only a-z0-9. For iso, max 30 characters. That's the vibe check — not me letting an invalid install_dir through 💀.
  • -L label — sets the ISO volume label. Default: MKARCHISO. Shoutout to the uppercase icon 👑.
  • -P publisher — sets the ISO publisher. Default: mkarchiso. Branding moment, honestly.
  • -c cert_and_key — provides certificates for codesigning of netboot artifacts as well as the rootfs artifact. Multiple files are provided as quoted, space delimited list. The first file is considered as the signing certificate, the second as the key and the third as the optional certificate authority. The way that shakes out: file one = signing certificate, file two = key, file three = optional CA — iykyk 🔐.
  • -g gpg_key — sets the PGP key ID to be used for signing the rootfs image. Passed to gpg as the value for --default-key. gpg girlies rise 🫶.
  • -G mbox — sets the PGP signer (must include an email address). Passed to gpg as the value for --sender. Email address required, bestie — no email, no signer 💌.
  • -h — help message. The classic “bestie, what do I do” button 💅.
  • -m mode — build mode(s) to use. Valid modes are: bootstrap, iso and netboot. Multiple build modes are provided as quoted, space delimited list. Default: iso. Pick your fighter(s) 🌈.
  • -o out_dir — sets the output directory. Default: ./out. All the finished lewks go here — ngl, keep it tidy ✨.
  • -p packages — package(s) to install. Multiple packages are provided as quoted, space delimited list. Pack it up, pack it in 🎒.
  • -r — deletes the working directory at the end. Cleanup queen behavior, we love to see it 😭.
  • -v — enables verbose output. She's talking, she's telling you everything, and honestly? Highkey helpful and I'm obsessed 👀.
  • -w work_dir — sets the working directory. Default: ./work. This is where the build chaos lives 💜.

🌟 EXAMPLES 🌟

🎀 Build the releng profile 🎀

mkarchiso /usr/share/archiso/configs/releng

run this and let her cook 🔥.

🐛 BUGS 🐛

👑 AUTHORS 👑

archiso is maintained by the Arch Linux community. Refer to the AUTHORS file for a full list of contributors. Community-built and iconic, no cap 💖.

Copyright 🄯 archiso contributors. GPL-3.0-or-later. Legal bestie moment, slay.

🦋 SEE ALSO 🦋

  • /usr/share/doc/archiso/README.profile.rst — the profile readme, go read it if you wanna understand the profile lore 🧚.

source/version check: archiso 92; page: mkarchiso(1); date: not shown in the original footer, so I'm not making one up — periodt 🙈💖. Now go build something iconic ✨

📦 where this page comes from