DNF5-OFFLINE(8)                      dnf5                      DNF5-OFFLINE(8)

NAME
       dnf5-offline -  Offline Command

SYNOPSIS
       dnf5 offline <subcommand> [options]

DESCRIPTION
       The offline command is used to manage "offline"
       transactions---transactions that run when the system is booted into a
       minimal environment. Running a transaction in this stripped-down
       environment can be safer than running it when the system is booted
       normally since the transaction is less likely to interfere with running
       processes.

       Offline transactions can be initiated by specifying the --offline flag
       on any operation (install, upgrade, distro-sync, etc.), or via dnf5
       system-upgrade download. Once an offline transaction is initiated, run
       dnf5 offline reboot to reboot and begin the transaction.

       Data for offline transactions is stored under the "system state"
       directory at /usr/lib/sysimage/libdnf5/offline.

SUBCOMMANDS

       clean
              Removes any stored offline transaction and deletes cached package files.


       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.


       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).


       status
              Shows the status of the current offline transaction.


       _execute
              Execute the transaction in the offline environment.


              WARNING:
                 For internal use only. Not intended to be run by the user.

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.


EXAMPLES

       dnf5 install --offline hello
              Prepares the installation of the hello package as an offline transaction.


       dnf5 offline status
              Shows the status of the current offline transaction.


       dnf5 offline reboot --poweroff
              Reboot and run the offline transaction, then power the system off after the transaction is complete.


       dnf5 offline log
              List boots during which an offline transaction was attempted.


       dnf5 offline log --number=-1
              View the log from the latest boot during which an offline transaction was attempted.


SEE ALSO
          dnf5-system-upgrade(8), System-upgrade command
          https://www.freedesktop.org/wiki/Software/systemd/SystemUpdates


AUTHOR
       See AUTHORS.md in dnf5 source distribution.

COPYRIGHT
       Contributors to the dnf5 project.

                                April 18, 2025                 DNF5-OFFLINE(8)