SETUP-LBU(8)

💾 SETUP-LBU — your local backup media glow-up ✨

okay so real talk, this is setup-lbu(8) from the System Manager's Manual, and it's basically the little matchmaker that introduces lbu to a disk. bestie, let's go 🫶

---

🌸 SYNOPSIS 🌸

setup-lbu [-hq] [MEDIA]

---

💅 DESCRIPTION 💅

so setup-lbu is the one who decides where lbu(8) gets to stash your apkovl archives. iconic behaviour. it does this by setting LBU_MEDIA in /etc/lbu/lbu.conf and, if it's not already there, adding the matching entry to /etc/fstab. two files, one vibe, zero chaos ✨

now, MEDIA is flexible like that — it can be:

• a plain name (like usb) 🍓
• a path under /media (like /media/usb) 🦋
• a filesystem label (LABEL=label) 🎀
• a UUID (UUID=uuid) 👑

and like, if you go the label-or-UUID route? a mount point gets created for you under /media. main character energy, honestly.

also important: when MEDIA is none, the script just exits without changes. no notes, no edits, we're done here 💀

if you don't pass a MEDIA at all, the script scans /media for mounted (non-iso9660) devices and checks for a filesystem labeled APKOVL. then it prompts you to choose. cute little choose-your-own-adventure 🌈

---

✨ OPTIONS ✨

• -h — display usage information and exit. short and sweet, like a good group chat reply 💜
• -q — quiet mode. it'll automatically pick a mounted media suggestion when one is available, and only prompts you when the choice is still uncertain. lowkey the "just decide for me" button 🙈

---

🧚 INTERACTIVE MODE 🧚

no MEDIA argument? okay, so the script scans /media for mounted (non-iso9660) devices and for a filesystem labeled APKOVL. the first mounted device gets offered as the default. thoughtful 💅

the prompt accepts:

• MEDIA — a media mount point name, like usb or sda1. heads up: the directory /media/MEDIA_ must exist. no directory, no deal 🎀
• none — exit without configuring backup media. bye bestie 👋
• LABEL=_label_ — select media by filesystem label. iykyk 🏷️

---

📁 FILES 📁

• /etc/lbu/lbu.conf — the lbu configuration file. setup-lbu sets LBU_MEDIA right here. this is the whole point of the operation 💖
• /etc/fstab — the filesystem table. a noauto,ro entry is added for the media if one doesn't already exist. respectfully, noauto,ro means it doesn't automount and it's read-only 🔥

---

⭐ EXIT STATUS ⭐

• 0 — success. slay, we ate 🎉
• non-zero — an error happened, bestie 😭 specifically: invalid media, missing device, or missing filesystem type.

---

🌟 SEE ALSO 🌟

lbu(8), setup-alpine(8) — go read these too, they're the supporting cast 👑

---

👑 AUTHORS 👑

Natanael Copa <ncopa@alpinelinux.org> and others 💜

---

and that's the whole page, no cap — Alpine Linux, dated 2026-06-09, living in the System Manager's Manual, section 8. mwah 💋