DNF5-ENVIRONMENT(8)

πŸ“¦
version 5.4.6.0 Β· 4 versions
, in fedora 44

✨ dnf5-environment β€” the Environment Command, bestie ✨

okay so this is the dnf5-environment page from the dnf5 manual, and it's literally all about environments β€” like, the big meta-groups that bundle a bunch of groups together. think "KDE Plasma Workspaces" energy. πŸŽ€


🌸 NAME 🌸

dnf5-environment β€” Environment Command. that's it, that's the name. iconic.


πŸ¦‹ SYNOPSIS πŸ¦‹

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

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

yes there are two forms. one is for looking, one is for doing. we love a duality. πŸ’…


πŸ’– DESCRIPTION πŸ’–

so the environment command in DNF5 does a whole bunch of querying β€” it gets you info about environments and the groups that belong to them β€” and it's also the thing you use to actually install an environment. 🫢

heads up: if you just wanna query groups on their own, that's a different command. use the separate group command for that. not this one. πŸ’€

you can optionally pass environment-spec arguments to filter down to environments with specific IDs or names. and here's the tea: install, remove and upgrade all accept both environment-spec and group-spec β€” but if something matches both an environment and a group, only the environments get affected. environments win. main character energy fr. πŸ‘‘


πŸ‘‘ SUBCOMMANDS πŸ‘‘

  • list β€” lists all matching environments, whether they're installed or available. if you don't specify anything, it lists all known environments. the --installed and --available options narrow the list down to what you want. πŸ’«
  • info β€” prints detailed info about environments. takes the exact same options as the list subcommand. twinning. ✨
  • install β€” marks the environments or groups you named as installed, and installs the groups and packages they contain.

if an environment or group is already (partially) installed, this command installs the missing groups and packages it contains. no cap.

in case both groups and environments match, only environments are affected.

for environments: all groups from their grouplist and the default groups from their optionlist get installed.

if the --with-optional option is used, optional packages of groups are included too. by default, all Mandatory and Default packages get installed whenever possible. Conditional packages get installed if they meet their requirement. you can configure this via dnf5.conf(5), specifically group_package_types.

if the --no-packages option is used, this command installs no packages at all. only the currently installed group packages count as installed with the groups. 😭

  • remove β€” marks the environments or groups you named as removed, and removes the groups and packages they contain β€” unless they belong to another installed environment or group, were installed explicitly by the user, or (in the case of packages) were installed as a dependency. it's giving ✨boundaries✨.

in case both groups and environments match, only environments are affected.

if the --no-packages option is used, this command removes no packages at all.

  • upgrade β€” upgrades the definition of the environments and groups you named, plus the groups and packages they contain. if new groups or packages got added to the current definitions since the environments or groups were installed, the new ones get installed. likewise, if some groups or packages got removed from the definition, they get removed too β€” unless they were installed for a different reason (they belong to another installed environment or group, were installed explicitly by the user, or were installed as a dependency).

in case both groups and environments match, only environments are affected.


🌈 OPTIONS FOR LIST AND INFO 🌈

  • --available β€” show only available environments. those are the ones that aren't installed but DNF5 knows about them. πŸ‘€
  • --installed β€” show only installed environments.

πŸ”₯ OPTIONS FOR INSTALL, REMOVE AND UPGRADE πŸ”₯

  • --with-optional β€” include optional packages from the groups. used with the install command.
  • --no-packages β€” operate exclusively on the environments and groups, without manipulating any packages. used with the install and remove commands.
  • --allowerasing β€” allow removing installed packages to resolve any potential dependency problems. used with the install and upgrade commands.
  • --skip-broken β€” resolve any dependency problems by removing the packages causing problems from the transaction. used with the install command.
  • --skip-unavailable β€” allow skipping packages that can't be installed or upgraded. used with the install and upgrade commands.
  • --allow-downgrade β€” enable downgrade of dependencies when resolving the requested operation. used with the install and upgrade commands.
  • --no-allow-downgrade β€” disable downgrade of dependencies when resolving the requested operation. used with the install and upgrade commands.
  • --downloadonly β€” download the resolved package set without executing an RPM transaction. used with the install and upgrade commands.
  • --offline β€” store the transaction to be performed offline. see the offline command, dnf5-offline(8). πŸŒ™
  • --transient β€” applicable only on bootc (bootable containers) systems. perform transactions using a transient overlay which will be lost on the next reboot. see also the persistence configuration option.
  • --store=PATH β€” store the current transaction in a directory at the specified PATH instead of running it. the stored transaction can be performed by the replay command, dnf5-replay(8). note that repository ids in the stored transaction are mangled to @stored_transaction(repo_id) β€” this is required because during replaying, the stored repositories are recreated and they might collide with already present repositories (this doesn't apply to the special @System repository). 😀 very specific, very important.

πŸ“ EXAMPLES πŸ“

  • dnf5 environment list β€” show list of all environments.
  • dnf5 environment info "KDE Plasma Workspaces" β€” show detailed info about the KDE environment.

πŸ’œ SEE ALSO πŸ’œ


πŸŽ€ Author πŸŽ€

See AUTHORS.md in dnf5 source distribution.

Contributors to the dnf5 project.


and that's the whole page bestie πŸ’– huge thanks to the dnf5 project, this dropped on Sep 24, 2026, and it's from the dnf5 manual, section 8. go forth and install your environments, you absolute icon. 🧚✨🫢

πŸ“¦ where this page comes from