man(1)

🌸 subuser — man(1) 💅

okay so bestie, you found yourself in the man(1) page for subuser, and honestly? you're about to have a whole personality shift. ✨

---

✨ NAME ✨

subuser — install, administer, and run desktop applications with Docker. 🐳💖

---

✨ SYNOPSIS ✨

subuser [SUBCOMMAND] [SUBCOMMAND ARGS]

---

✨ DESCRIPTION ✨

Bestie. subuser lets you install and administer desktop applications that are contained using Docker. no cap. 🫶

this is genuinely useful if you need to:

• provide portability across Linux distributions 🌈
• get heightened security 🔒

the applications have limited access to the main system and user files. like, they're on a leash (affectionate). 🎀

and the way they get access? solely through a whitelisting permissions file. that's it. that's the whole vibe check. 💅

---

✨ OPTIONS ✨

pass the --help option to any subcommand to find its options, bestie. every single one has them. 👑

the following subcommands are available:

• subuser — add, remove, and configure subusers 🧚
• run — run subusers 🏃‍♀️
• repository — add and configure repositories 📦
• update — update subuser images ⬆️
• remove-old-images — remove unused images to free up disk space 🧹 (so satisfying, honestly)
• registry — interact with the subuser registry 🗂️
• list — list subusers and images 📋
• describe — describe subusers and images 🔍
• repair — repair your subuser installation. useful after migrating to a new system 🩹
• pkg — create new subuser images 🛠️
• dev — use subuser to create portable and reproducible dev environments 💻
• version — print subuser's version information ℹ️

---

✨ EXAMPLES ✨

🦋 create a subuser

to create a subuser named web-browsing based on the iceweasel image:

$ subuser subuser add web-browsing iceweasel@default

🦋 run that subuser

$ subuser run web-browsing

🦋 create a second subuser

to create a second subuser, also based on the iceweasel image, but this time reserved for internet banking 💸:

$ subuser subuser add internet-banking iceweasel@default

🦋 run that subuser

$ subuser run internet-banking

🦋 add a subuser to the PATH

$ subuser subuser add-to-path internet-banking

🦋 update your subuser images

$ subuser update all

all updates are atomic, and you can continue to use your subusers while the update command is running. multitasking icon behavior. 🔥

if you find that an older version of a subuser's image was better, you can always roll back the update for that subuser:

$ subuser registry log
$ subuser lock-subuser-to internet-banking <commit-hash-from-log>

---

✨ AUTHOR ✨

Timothy Hobbs (timothy.hobbs.cz) 🫶

---

and that's the whole page, bestie — go forth and containerize responsibly ✨💖

this was subuser 0.5.6, dated 28 March 2016 🌸 mwah, bye 💅🎀