carapace-sh/carapace-bin / skills/dnf5
dnf5
VerifiedUse when working with dnf5 — the next-generation RPM package manager for Fedora/RHEL. Covers CLI commands and options, configuration, plugin system (dnf5 active plugins and libdnf5 passive plugins), dnf5daemon D-Bus API, execution workflow, package specs (NEVRA), modularity, caching, migration from DNF4, libdnf5 library architecture, build system, and command-line aliases. Triggers on: "dnf5", "dnf", "libdnf5", "libdnf", "dnf5daemon", "dnf5-plugins", "libdnf5-plugins", "dnf5.conf", "repoquery", "versionlock", "distro-sync", "offline upgrade", "system-upgrade", "advisory", "comps", "modulemd", "NEVRA", "installroot", "forcearch", "repo variables", "metadata_expire", "setopt", "setvar", "config-manager", "repofrompath", "releasever", "basearch", "pluginpath".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.1 KB |
| references/aliases.md | markdown | 4.6 KB |
| references/build.md | markdown | 6.1 KB |
| references/caching.md | markdown | 4.6 KB |
| references/cli.md | markdown | 8.1 KB |
| references/comps.md | markdown | 1.7 KB |
| references/configuration.md | markdown | 15.7 KB |
| references/daemon.md | markdown | 13.4 KB |
| references/filtering.md | markdown | 2.2 KB |
| references/forcearch.md | markdown | 1.5 KB |
| references/installroot.md | markdown | 2.5 KB |
| references/libdnf5.md | markdown | 7.0 KB |
| references/migration.md | markdown | 8.5 KB |
| references/modularity.md | markdown | 4.1 KB |
| references/plugins.md | markdown | 16.2 KB |
| references/repo-variables.md | markdown | 2.4 KB |
| references/specs.md | markdown | 4.2 KB |
| references/system-state.md | markdown | 2.0 KB |
| references/workflow.md | markdown | 7.5 KB |
references/installroot.md
View on GitHub# DNF5 Installroot
The `--installroot` parameter specifies an alternative root filesystem for all packaging operations.
> **Source of truth**: <https://dnf5.readthedocs.io/en/stable/misc/installroot.7.html>.
## Overview
It is like doing `chroot <root> dnf`, but `--installroot` allows DNF5 to work before the chroot is created.
```bash
dnf5 --installroot=/mnt/root install system-release
```
## Path Resolution Rules
| Item | Source | Notes |
|------|--------|-------|
| `cachedir`, `system_cachedir` | Installroot | Taken from or stored in installroot |
| Log files | Installroot | |
| `releasever` | Installroot | Detected from RPMDB inside installroot |
| `gpgkey` | Installroot | OpenPGP keys imported into installroot from path relative to host |
| Configuration file | Installroot | Unless `--use-host-config` is passed |
| `reposdir` | Installroot | Unless `--use-host-config` is passed |
| `vars` | Installroot | Unless `--use-host-config` is passed |
| Command-line paths (`--config`, `--setopt=reposdir=`, `--setopt=cachedir=`, `--setopt=system_cachedir=`, `--setopt=logdir=`, `--setopt=varsdir=`) | **Host** | Always relative to host, no exceptions |
| `pluginpath`, `pluginconfpath` | **Host** | Always relative to host |
## `--use-host-config`
When `--use-host-config` is passed:
- Configuration files and variable definitions are taken from the **host system** (`/`)
- `releasever` is detected from the host (`/`)
- Useful when the installroot doesn't have its own configuration yet
## Important Notes
### Creating a New Installroot
When creating an installroot, use `--releasever=RELEASEVER`:
```bash
dnf5 --installroot=/mnt/root --releasever=40 install system-release
```
Otherwise `$releasever` is taken from the RPMDB inside the installroot (empty at creation time, causing transaction failure).
### Modular Systems
Use `--setopt=module_platform_id=<module_platform_name:stream>` when creating the installroot:
```bash
dnf5 --installroot=/mnt/root --setopt=module_platform_id=platform:el9 install system-release
```
Otherwise `module_platform_id` is taken from `/etc/os-release` inside the installroot (empty at creation, modular dependency could be unsatisfied, modules content could be excluded).
## Examples
```bash
# Permanently set releasever in the installroot
dnf5 --installroot=/mnt/root --releasever=40 install system-release
# Use config from a specific path
dnf5 --installroot=/mnt/root --setopt=reposdir=/path/to/repodir --config /path/dnf.conf upgrade
# Use host configuration
dnf5 --installroot=/mnt/root --use-host-config --releasever=40 install @core
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |