DNF5-GROUP(8)                        dnf5                        DNF5-GROUP(8)

NAME
       dnf5-group - Group Command

SYNOPSIS
       dnf5 group {list|info} [options] [<group-spec>...]

       dnf5 group {install|remove|upgrade} [options] <group-spec>...

DESCRIPTION
       The group command in DNF5 offers several queries for getting
       information about groups, packages related to them and it is also used
       for groups installation.  To query environments use separate
       environment command.  Note: dnf-4 listed both environments and groups
       with the group command.

       Optional group-spec arguments could be passed to filter only groups
       with given names.

SUBCOMMANDS

       list   List all matching groups, either among installed or available
              groups. If nothing is specified, list all known groups.
              --installed and --available options narrow down the requested
              list. If --hidden option is used, also hidden groups are
              included in the list.

       info   Print detailed information about groups.  The command accepts
              the same options as the list subcommand.

       install
              Mark the specified groups installed and install packages it
              contains.  Also include optional packages of the group if the
              --with-optional option is specified. By default all Mandatory
              and Default packages will be installed whenever possible.
              Conditional packages are installed if they meet their
              requirement. This can be configured by dnf5-conf(5),
              group_package_types.

              If the group is already (partially) installed, the command
              installs the missing packages from the group.

              If the --no-packages option is used, no new packages will be
              installed by this command. Only currently installed group
              packages are considered to be installed with the group.

       remove Mark the group removed and remove those packages in the group
              from  the system  which  do not belong to another installed
              group and were not installed explicitly by the user.

              If the --no-packages option is used, no packages will be removed
              by this command.

       upgrade
              Upgrade a definition of the specified group and the packages
              belonging to the group. If new packages have been added to the
              current definition of the group since the group was installed,
              the new packages will be installed. Likewise, if some packages
              have been removed from the group definition, the packages will
              be uninstalled unless they were installed for a different reason
              (e.g.  explicitly installed by a user or implicitly installed as
              a dependency).

OPTIONS FOR LIST AND INFO

       --available
              Show only available groups. Those which are not installed, but known to DNF5.


       --installed
              Show only installed groups.


       --hidden
              Show also hidden groups.


       --contains-pkgs=PACKAGE_NAME,...
              Show only groups containing packages with specified names. List option, supports globs.


OPTIONS FOR INSTALL, REMOVE AND UPGRADE

       --with-optional
              Include optional packages from the groups.
              Used with install command.


       --no-packages
              Operate exclusively on the groups without manipulating any packages.
              Used with install and remove commands.


       --allowerasing
              Allow removing of installed packages to resolve any potential dependency problems.
              Used with install and upgrade commands.


       --skip-broken
              Resolve any dependency problems by removing packages that are causing problems from the transaction.
              Used with install command.


       --skip-unavailable
              Allow skipping packages that are not possible to install or upgrade.
              Used with install and upgrade commands.


       --allow-downgrade
              Enable downgrade of dependencies when resolving the requested operation.
              Used with install and upgrade commands.


       --no-allow-downgrade
              Disable downgrade of dependencies when resolving the requested operation.
              Used with install and upgrade commands.


       --downloadonly
              Download the resolved package set without executing an RPM transaction.
              Used with install and upgrade commands.


       --offline
              Store the transaction to be performed offline. See dnf5-offline(8), Offline command.


EXAMPLES

       dnf5 group list --hidden
              Show list of all groups, including hidden ones.


       dnf5 group info *xfce*
              Show detailed info about all groups related to Xfce.


       dnf5 group install mysql --with-optional
              Install the mysql group including optional packages.


       dnf5 group upgrade mysql
              Bring packages of the mysql group to compliance with a current
              definition of the group.


SEE ALSO
          dnf5-comps(7), Comps groups and environments
          dnf5-specs(7), Patterns specification


AUTHOR
       See AUTHORS.md in dnf5 source distribution.

COPYRIGHT
       Contributors to the dnf5 project.

                                April 18, 2025                   DNF5-GROUP(8)