man(1)

📦 version 1.0.1, in alpine 3.22, alpine 3.23, alpine 3.24

🌸 man(1) — the setup-box glow-up guide 💅

ok so bestie, this is the manual page for setup-box (yes it lives in the man manual, section 1, we love a classic) and it's literally your shortcut to getting a whole Alpine Linux environment set up without losing your mind. buckle up 🎀

✨ NAME ✨

setup-box — sets up a whole variety of Alpine Linux environments for you 🦋

✨ SYNOPSIS ✨

setup-box option [args]

✨ DESCRIPTION ✨

okay so here's the vibe: setup-box takes a predefined list of packages and uses it to build the environment you want. lowkey iconic. 🔥

and like, you're not stuck with just the presets — you can also make your own customized environment by editing or creating a proper .json file that lives at /etc/setup-box/json. your world, your rules 💖

🚨 important bestie: you must run setup-box as root, because it is going to install some packages. no cap, root only.

✨ OPTIONS ✨

  • -d — picks one of the supported desktop environments (peep DESKTOPS below 👀). and honestly, -u is a genuinely useful option to pair with this one. duo energy 🫶
  • -u — makes a user with the username you choose. here's the tea tho: if -d was set but -u was not, then a default user gets created for you anyway. also heads up, this option is valid just in case -d was passed — so it only works alongside -d 💅
  • -g — defines a group to install (see -G) 🍓
  • -s — defines a subgroup to install (see -S) 🌸
  • -h — shows help. your bestie when you're lost 😭
  • -G — lists all the available groups 👑
  • -S — lists all the available subgroups ⭐
  • -v — shows any error — just in case 🙈
  • -V — shows the setup-box version 💀

✨ DESKTOPS ✨

the desktop environments that are available are: mate, openbox, xfce 🌈

✨ EXAMPLES ✨

installing MATE Desktop for Jane, with Internet applications and Pentest tools — look at her go, main character energy 👑

~# setup-box -d mate -u jane -s desktop_extras.internet -g pentest

installing a basic environment with Gparted — simple, clean, ate 💜

~# setup-box -d openbox -s systools.disk

✨ REPORTING BUGS ✨

found a bug? report it to the author, they wanna know fr fr 🧚

✨ AUTHOR ✨

Alan Lacerda <alacerda@alpinelinux.org> 💖

✨ SEE ALSO ✨

setup-alpine 🦋

💀 reminder bestie: root only, and if -d was set without -u, a default user is getting created whether you planned it or not. iykyk.

and that's the whole page! 🌸 this one's version 1.0, dated 18 Jun 2015 — vintage, honestly. mwah, go set up something slay ✨🎀💅

📦 where this page comes from