PAM_NAMESPACE_HELPER(8)

💅 PAM_NAMESPACE_HELPER 💅

okay so bestie, welcome to pam_namespace_helper — that's the pam_namespace_helper(8) page if you're being formal about it, and she lives in the Linux-PAM Manual 💖

---

✨ NAME ✨

pam_namespace_helper — the helper binary that creates home directories 🏠✨ no cap.

---

🦋 SYNOPSIS 🦋

pam_namespace_helper

that's it. that's the whole thing. she takes zero arguments and she doesn't need them 💅

---

🌸 DESCRIPTION 🌸

so like, pam_namespace_helper is a helper program for the pam_namespace module, and her whole job is setting up a private namespace for a session that has polyinstantiated directories going on. it's giving backstage crew energy — you don't see her, but nothing works without her 🫶

the way she does it: the helper makes sure the namespace mount points exist before they get started to be used for the polyinstantiated directories. like, she's setting up the venue before the party, fr fr. you can't mount into a place that isn't there yet 😭

⚠️ lowkey important: mount points for home directories — the lines with $HOME in them — are NOT created. she does not touch those. periodt. 💀

---

🎀 when should you run her? 🎀

• pam_namespace_helper should be run by systemd at system startup. that's her main character moment ⭐
• she should also be run by the administrator — and the order here is the whole plot bestie — after defining the polyinstantiated directories but before enabling them. after defining, before enabling. do not flip those. 🙈

---

👑 SEE ALSO 👑

• pam_namespace(8) — her bestie, her other half, the module she's helping 🌈

---

💜 AUTHOR 💜

Written by Topi Miettinen. iconic behavior, we love to see it 🎀✨

---

and that's the whole page bestie!! 🌸🦋 this one came from the Linux-PAM Manual and she's dated 09/27/2026 — screenshot it, memorize it, go run her at startup like the responsible system administrator you are 💅🍓💖