ZPOOL-DETACH(8)

✨ ZPOOL-DETACH 💅

okay bestie, welcome to zpool-detach from the System Manager's Manual — it's the glow-up where you detach a device from a ZFS mirror. no cap, it's giving "breakup era" but for disks. 🦋

---

🌸 NAME 🌸

zpool-detach — detach device from ZFS mirror 💔

---

🎀 SYNOPSIS 🎀

zpool detach pool device

like. that's the whole move. pool and device, that's it, that's the vibe check. ✨

---

👑 DESCRIPTION 👑

So here's the tea, bestie: zpool detach detaches device from a mirror. she's out, she's gone, she's not coming to the group chat anymore. 🫶

BUT. 🛑 The operation is refused if there are no other valid replicas of the data. like, the pool will literally be like "girl no" because you'd be deleting your only copy. absolutely not, we don't do data loss in this house. 💀

And lowkey important: if device might be re-added to the pool later on, then bestie... consider the zpool offline command instead. fr fr. detach is a divorce, offline is just a break. 🙈

---

🌈 SEE ALSO 🌈

the whole friend group, obviously:

• zpool-attach(8) — the get-back-together arc 💖
• zpool-labelclear(8) — cleaning up the label situation 🧚
• zpool-offline(8) — the "we're on a break" option 💜
• zpool-remove(8) — different energy, still slays 🔥
• zpool-replace(8) — swap her out, main character energy 👑
• zpool-split(8) — the pool goes its separate ways ⭐

---

OpenZFS • July 11, 2022

and that's the whole page bestie, mwah 💋 stay hydrated, back up ur data, and remember: detach responsibly 🎀✨🦋