DNF5-OFFLINE(8)

📦
version 5.4.6.0 · 4 versions
, in fedora 44

💅 dnf5-offline — the Offline Command, bestie

okay so you're in the dnf5-offline(8) zone, which is part of the dnf5 manual. this is the whole vibe: managing transactions that happen while your system is booted into a minimal environment. yes, that kind of offline. let's go 🦋

✨ SYNOPSIS ✨

dnf5 offline <subcommand> [options]

🌸 DESCRIPTION 🌸

bestie. the offline command is your girl for managing "offline" transactions — and by that we mean transactions that run when the system is booted into a minimal environment. that's the whole thing.

and why is that iconic? because running a transaction in this stripped-down environment can be safer than running it while the system is booted normally — the transaction is less likely to interfere with running processes. no chaos, no drama, no fighting with stuff that's already running. periodt 💅

so how do you even start one? you've got two doors, both slay:

  • slap the --offline flag on any operation (install, upgrade, distro-sync, etc.) — literally any of them
  • or go through dnf5 system-upgrade download

once an offline transaction is initiated, you run dnf5 offline reboot to reboot and begin the transaction. that's the ritual, no cap.

also, where does all this live? data for offline transactions is stored under the "system state" directory at /usr/lib/sysimage/libdnf5/offline. remember that path, it's giving ✨important✨.

🎀 SUBCOMMANDS 🎀

  • clean — Removes any stored offline transaction and deletes cached package files. it's the cleanup queen 🧹
  • log — Used to see a list of boots during which an offline transaction was attempted, or show the logs from an attempted offline transaction. The logs for one of the boots can be shown by specifying one of the numbers in the first column with the --number argument. Negative numbers can be used to number the boots from last to first. For example, log --number=-1 can be used to see the logs for the last offline transaction. so basically negative indexing but for boot logs — iykyk 🫶
  • reboot — Prepares the system to perform the offline transaction and reboots to start the transaction. This command can only be run after an offline transaction is initiated (e.g. by dnf5 system-upgrade download). so don't come at it empty-handed, it needs a transaction to exist first 🙈
  • status — Shows the status of the current offline transaction. the vibe check of the whole operation 💖
  • _execute — Execute the transaction in the offline environment.
Warning: For internal use only. Not intended to be run by the user. seriously bestie, this is the staff-only door, do not touch 🔥

👑 OPTIONS 👑

  • --number=<boot number> — Show the log specified by the number. Run dnf5 offline log with --number first to get a list of logs to choose from. Used with the log subcommand.
  • --poweroff — The system will power off after the transaction is completed instead of restarting. If the transaction failed, the system will reboot instead of powering off even with this flag. Used with the reboot subcommand.

🌈 ENVIRONMENT 🌈

  • DNF_SYSTEM_UPGRADE_NO_REBOOT — If set, the system won't be rebooted or powered off by DNF5 when the normal work flow would do so. it's the "not me, not today" switch 🛑

⭐ EXAMPLES ⭐

the moment you've all been waiting for. slay:

dnf5 install --offline hello

Prepares the installation of the hello package as an offline transaction. cute, small, respectful 🍓

dnf5 offline status

Shows the status of the current offline transaction. always check your status, bestie.

dnf5 offline reboot --poweroff

Reboot and run the offline transaction, then power the system off after the transaction is complete. it does the thing, then it dips 😭💀

dnf5 offline log

List boots during which an offline transaction was attempted. the receipts 📜

dnf5 offline log --number=-1

View the log from the latest boot during which an offline transaction was attempted. negative one = most recent, iconic behaviour fr fr.

💜 SEE ALSO 💜

🫶 Author 🫶

See AUTHORS.md in dnf5 source distribution.

Contributors to the dnf5 project.

and that's the whole page, bestie! this was DNF5-OFFLINE(8) from the dnf5 manual, dated Sep 24, 2026. go forth and run your offline transactions safely, ily, mwah 💖✨🎀

📦 where this page comes from