MINI-BUI...SSH-SETUP(8)

💖 MINI-BUI...SSH-SETUP(8) 💖

okay bestie, this is mini-buildd-ssh-setup from the System Administration Utilities crew — a whole manual page just for you, and honestly? it's giving iconic. 🎀

---

✨ NAME ✨

mini-buildd-ssh-setup — the idempotent setup script for SSH access. yes, idempotent, meaning you can run it again and again and it won't get weird about it. slay. 💅

---

🌸 SYNOPSIS 🌸

mini-buildd-ssh-setup [[<ENDPOINT>]|[--purge]]  (as user root)

run it as root, no cap. 👑

---

🦋 DESCRIPTION 🦋

so like… it's an idempotent setup script for SSH access. that's the whole vibe. 🫶

🎀 the three UNIX users

it creates and sets up three UNIX users, and each one matches a mini-buildd user with the same name. matching names, matching energy. periodt.

• mini-buildd-uploader — lets people upload via SSH 📤
• mini-buildd-staff — lets people make API calls with 'staff' authorization via SSH 🧚
• mini-buildd-admin — lets people make API calls with 'admin' authorization via SSH 👑

💜 the extra work you gotta do on mini-buildd

not me making you do homework, but here we are:

• BEFORE running this — bestie, please create all the three mini-buildd users first. like, all three. 🙈
• AFTER running this — go check / configure / activate the Upload Profile for the user mini-buildd-uploader. do not skip this one. ⭐

🌈 when this is up

okay so now the fun part:

• Grant someone access — peep the example line that got dropped into the created authorized_keys files of the respective users. it's right there, i promise. 🎀
• Run API calls</seap> — like this:

ssh mini-buildd-staff|admin@<yourhost> mini-buildd-api <mini_buildd_api_args>

heads up bestie: you need the _complete_ arguments — including the correct user endpoint, like 'http://mini-buildd-staff@<yourhost>:8066'. don't be out here sending half the args and wondering why it's not working. 😭

• Upload</seap> — an extra .dput.cf gets generated in /var/lib/mini-buildd/etc/dput.cf (that's for the dput_conf API call). authorized users can now also upload with this new target. ate. 🔥

💀 caveats (the serious bit, stay with me)

someone with access to mini-buildd-uploader could potentially copy from or write to arbitrary locations (within the mini-buildd-uploader user's permissions).

okay that one's real. that's a genuine security note, not a drill — arbitrary locations, within that user's permissions. read it twice. 🫡

---

that's the whole page, bestie. go set up those users. 💖

mini-buildd-ssh-setup 2.4.8ub… February 2026 ✨ MINI-BUI...SSH-SETUP(8) — mwah, bye, love u, see u in the man pages. 🎀🦋💜