DISTROBOX-UPGRADE(1)

💖 distrobox-upgrade — the glow-up era 💖

okay bestie, this one is from the distrobox-upgrade manual, and it's literally the "time to update everything" button you've been begging for. no cap.

---

✨ NAME ✨

distrobox-upgrade — the icon, the moment, the container updater 🫶

---

🌸 DESCRIPTION 🌸

so here's the vibe: distrobox-upgrade will walk into the list of containers you hand it and perform an upgrade using that container's own package manager. like, it doesn't impose, it doesn't assume — it just shows up at each distrobox's door and lets it update itself the way it knows how. respectful. elegant. iconic. 💅

---

🦋 SYNOPSIS 🦋

distrobox upgrade

and here's every flag, no skips, no cuts, all of them:

• --help, -h — show this message. the "wait what does this do again" button 🙈
• --all, -a — perform for all distroboxes. all of them. every single one. periodt 👑
• --running — perform only for running distroboxes. like, only the ones currently awake, the rest are napping and we don't disturb them 😴
• --root, -r — launch podman/docker/lilipod with root privileges. and listen, bestie: if you need root, this is the preferred way over sudo distrobox. and also — note that if using a program other than 'sudo' for root privileges is necessary, specify it through the DBX_SUDO_PROGRAM env variable, or the distrobox_sudo_program config variable. iykyk 🔥
• --verbose, -v — show more verbosity. it will yap. and honestly? sometimes you need the yap 💬
• --version, -V — show version ⭐

---

🌈 EXAMPLES 🌈

upgrade all distroboxes

distrobox-upgrade --all

upgrade all running distroboxes

distrobox-upgrade --all --running

upgrade a specific distrobox

distrobox-upgrade alpine-linux

upgrade a list of distroboxes

distrobox-upgrade alpine-linux ubuntu22 my-distrobox123

automatically update all distro

okay this part is the main character energy moment, fr fr. you can create a systemd service to perform distrobox-upgrade automatically, and this example shows how to run it daily:

~/.config/systemd/user/distrobox-upgrade.service

[Unit]
Description=distrobox-upgrade Automatic Update

[Service]
Type=simple
ExecStart=distrobox-upgrade --all
StandardOutput=null

~/.config/systemd/user/distrobox-upgrade.timer

[Unit]
Description=distrobox-upgrade Automatic Update Trigger

[Timer]
OnBootSec=1h
OnUnitInactiveSec=1d

[Install]
WantedBy=timers.target

then simply do a systemctl --user daemon-reload && systemctl --user enable --now distrobox-upgrade.timer — and that's it, she's self-sufficient now, she doesn't need you anymore (affectionate) 🧚

---

ok that's literally the whole page, every flag and every example, nothing skipped, nothing invented 💜

---

that's the whole manual, bestie — Distrobox, Mar 2026, DISTROBOX-UPGRADE(1) 🎀 go update something, you deserve it. bye pookie ✨