.TH "fwupd.conf" "5" "" 1.9.19 "Configuration File Format"
.hy
.SH
NAME 
.PP
\f[B]fwupd.conf\f[R] — configuration file for the fwupd daemon.  
.SH
SYNOPSIS 
.PP
The \f[B]/etc/fwupd/fwupd.conf\f[R] file is the main configuration file for the fwupd daemon.  The complete description of the file format and possible parameters are documented here for reference purposes.  
.SH
FILE FORMAT 
.PP
The file consists of a multiple sections with optional parameters. Parameters are of the form: 
.PP
.nf
\f[B]\f[R]\f[B]
.fi
.nf
[section]
.fi
.nf
key = value
.fi
\f[R]\f[B]\f[R] 
.PP
The file is line-based, each newline-terminated line represents either a comment, a section name or a parameter.  
.PP
Section and parameter names are case sensitive.  
.PP
Only the first equals sign in a parameter is significant.  Whitespace before or after the first equals sign is discarded as is leading and trailing whitespace in a parameter value.  Internal whitespace within a parameter value is retained.  
.PP
Any line beginning with a hash (\f[B]#\f[R]) character is ignored, as are lines containing only whitespace.  
.PP
The values following the equals sign in parameters are all either a string (no quotes needed), unsigned integers, or a boolean, which may be given as \f[B]true\f[R] or \f[B]false\f[R].  Case is not significant in boolean values, but is preserved in string values.  
.SH
DAEMON PARAMETERS 
.PP
The \f[B][fwupd]\f[R] section can contain the following parameters: 
.PP
\f[B]DisabledDevices=\f[R] 
.PP
  Allow blocking specific devices by their GUID, using semicolons as delimiter.  
.PP
\f[B]DisabledPlugins=\f[R] 
.PP
  Allow blocking specific plugins by name.    Use \f[B]fwupdmgr get-plugins\f[R] to get the list of plugins.  
.PP
\f[B]ArchiveSizeMax=\f[R] 
.PP
  Maximum archive size that can be loaded in Mb, with 25% of the total system memory as the default.  
.PP
\f[B]IdleTimeout=300\f[R] 
.PP
  Idle time in seconds to shut down the daemon, where a value of \f[B]0\f[R] specifies “never”.  
.PP
  \f[B]NOTE:\f[R] some plugins might inhibit the auto-shutdown, for instance thunderbolt.  
.PP
\f[B]IdleInhibitStartupThreshold=500\f[R] 
.PP
  If the daemon takes more than this time to startup (in milliseconds) then inhibit the idle   shutdown timer. A value of \f[B]0\f[R] specifies “never”.  
.PP
\f[B]VerboseDomains=\f[R] 
.PP
  Comma separated list of domains to log in verbose mode.    If unset, no domains are set to verbose.    If set to “*”, all domains are verbose, which is the same as running the daemon with \f[B]--verbose --verbose\f[R].  
.PP
\f[B]UpdateMotd=true\f[R] 
.PP
  Update the message of the day (MOTD) on device and metadata changes.  
.PP
\f[B]EnumerateAllDevices=false\f[R] 
.PP
  For some plugins, enumerate only devices supported by metadata.  
.PP
\f[B]ApprovedFirmware=\f[R] 
.PP
  A list of firmware checksums that has been approved by the site admin   If unset, all firmware is approved.  
.PP
\f[B]BlockedFirmware=\f[R] 
.PP
  Allow blocking specific devices by their cabinet checksum, either SHA-1 or SHA-256.  
.PP
\f[B]UriSchemes=file;https;http;ipfs\f[R] 
.PP
  Allowed URI schemes in the preference order; failed downloads from the first scheme will be retried with the next in order until no choices remain.  
.PP
\f[B]IgnorePower=false\f[R] 
.PP
  Ignore power levels of devices when running updates.  
.PP
\f[B]OnlyTrusted=true\f[R] 
.PP
  Only support installing firmware signed with a trusted key.    Do not set this to \f[B]false\f[R] on a production or trusted system.  
.PP
\f[B]ShowDevicePrivate=true\f[R] 
.PP
  Show data such as device serial numbers which some users may consider private.  
.PP
\f[B]AllowEmulation=false\f[R] 
.PP
  Allow capturing and loading device emulation by logging all USB transfers.    Enabling this will greatly increase the amount of memory fwupd uses when upgrading devices.  
.PP
\f[B]TrustedUids=\f[R] 
.PP
  UIDs matching these values that call the D-Bus interface should marked as trusted.  
.PP
\f[B]HostBkc=\f[R] 
.PP
  Comma separated list of best known configuration IDs to be used when using \f[B]fwupdmgr sync\f[R].    This can downgrade firmware to factory versions or upgrade firmware to a supported config level. e.g. \f[B]vendor-factory-2021q1,mycompany-2023\f[R] 
.PP
\f[B]ReleaseDedupe=true\f[R] 
.PP
  Deduplicate duplicate releases by the archive checksum are available from more than one source.  
.PP
\f[B]ReleasePriority=local\f[R] 
.PP
  When the same version release is available from more than one source this option can be used to   either prefer the local version (avoiding a potentially expensive download) or to prefer the   remote version (which may have updated metadata such as release notes).  
.PP
  The possible options are \f[B]local\f[R] or \f[B]remote\f[R] or empty to not make any adjustment to the policy,   relying on the \f[B]OrderAfter\f[R] and \f[B]OrderBefore\f[R] sections in the remote.  
.PP
\f[B]EspLocation=\f[R] 
.PP
  Set the preferred location used for the EFI system partition (ESP) path.    This is typically used if UDisks was not able to automatically identify the location for any reason.  
.PP
\f[B]Manufacturer=\f[R] 
.PP
\f[B]ProductName=\f[R] 
.PP
\f[B]ProductSku=\f[R] 
.PP
\f[B]Family=\f[R] 
.PP
\f[B]EnclosureKind=\f[R] 
.PP
\f[B]BaseboardProduct=\f[R] 
.PP
\f[B]BaseboardManufacturer=\f[R] 
.PP
  Override values for SMBIOS or Device Tree data on the local system.    These are only required when the SMBIOS or Device Tree data is invalid, missing, or to simulate running on another system.    Empty values should be used to populate blank entries or add values to populate specific entries.  
.PP
\f[B]TrustedReports=VendorId=$OEM\f[R] 
.PP
  Vendor reports matching these expressions will have releases marked as \f[B]trusted-report\f[R].    Each *OR* section is delimited by a \f[B];\f[R] and each *AND* section delimited by \f[B]&\f[R], e.g.  
.PP
.IP \[bu] 2
\f[B]DistroId=chromeos\f[R]
.PP
  Any report uploaded from ChromeOS is trusted.  
.PP
.IP \[bu] 2
\f[B]DistroId=chromeos&RemoteId=lvfs\f[R]
.PP
  Any report found in the \f[B]lvfs\f[R] remote uploaded from a ChromeOS machine is trusted.  
.PP
.IP \[bu] 2
\f[B]DistroId=fedora&VendorId=19\f[R]
.PP
  Any report uploaded from Fedora 19 is trusted.  
.PP
.IP \[bu] 2
\f[B]DistroId=fedora&VendorId=$OEM\f[R]
.PP
  Any report uploaded from Fedora by the hardware OEM is trusted.  
.PP
.IP \[bu] 2
\f[B]DistroId=fedora;DistroId=rhel&DistroVersion=9\f[R]
.PP
  Any report uploaded from Fedora (any version) or from RHEL 9 is trusted.  
.PP
  NOTE: a \f[B]VendorId\f[R] of \f[B]$OEM\f[R] represents the OEM vendor ID of the vendor that owns the firmware,   for example, where Lenovo QA has generated a signed report for a Lenovo laptop.  
.PP
  There are also three os-release values available, \f[B]$ID\f[R], \f[B]$VERSION_ID\f[R] and \f[B]$VARIANT_ID\f[R], which   allow expressions like: 
.PP
.IP \[bu] 2
\f[B]DistroId=$ID\f[R]
.PP
.IP \[bu] 2
\f[B]DistroId=$ID,DistroVersion=$VERSION_ID\f[R]
.PP
.IP \[bu] 2
\f[B]Flags=is-upgrade,from-oem\f[R]
.PP
  Any flags listed here must all be matched by the report.  
.PP
\f[B]P2pPolicy=metadata\f[R] 
.PP
  This tells the daemon what peer-to-peer policy to use. For instance, using Passim, an optional   local caching service. Using peer-to-peer data might reduce the amount of bandwidth used on your   network considerably.  
.PP
  There are three possible values: 
.PP
.IP \[bu] 2
\f[B]nothing\f[R]: Do not publish any files
.PP
.IP \[bu] 2
\f[B]metadata\f[R]: Only publish shared metadata that is common to each machine.
.PP
.IP \[bu] 2
\f[B]firmware\f[R]: Only publish firmware archives \f[B]after the next reboot\f[R] of the machine.
.PP
  At some point in the future fwupd will change the default to \f[B]metadata,firmware\f[R].  
.PP
\f[B]TestDevices=false\f[R] 
.PP
  Create virtual test devices and remote for validating daemon flows.    This is only intended for CI testing and development purposes.  
.PP

.SH
UEFI_CAPSULE PARAMETERS 
.PP
The \f[B][uefi_capsule]\f[R] section can contain the following parameters: 
.PP
\f[B]EnableGrubChainLoad=false\f[R] 
.PP
  Configure GRUB to launch \f[B]fwupdx64.efi\f[R] instead of using other methods such as NVRAM or Capsule-On-Disk.  
.PP
\f[B]DisableShimForSecureBoot=false\f[R] 
.PP
  The shim loader is required to chainload the fwupd EFI binary unless the \f[B]fwupd.efi\f[R] file has been self-signed manually.  
.PP
\f[B]RequireESPFreeSpace=0\f[R] 
.PP
  Amount of free space required on the ESP, for example using \f[B]32\f[R] for 32Mb.    By default this is dynamically set to at least twice the size of the payload.  
.PP
\f[B]DisableCapsuleUpdateOnDisk=false\f[R] 
.PP
  Allow ignoring the CapsuleOnDisk support advertised by the firmware.  
.PP
\f[B]EnableEfiDebugging=false\f[R] 
.PP
  Enable the low-level debugging of \f[B]fwupdx64.efi\f[R] to the \f[B]FWUPDATE_DEBUG_LOG\f[R] EFI variable.  
.PP
  \f[B]NOTE:\f[R] enabling this option is going to fill up the NVRAM store much more quickly and   should only be enabled when debugging an issue with the EFI binary.  
.PP
  This value also has no affect when using Capsule-on-Disk as the EFI helper binary is   not being used.  
.PP
\f[B]RebootCleanup=true\f[R] 
.PP
  Delete any capsule files copy to the ESP, and remove any EFI variables set for the update.  
.PP
  \f[B]NOTE:\f[R] disabling this option is only required when debugging the flash process and normal   users should not need to change this setting.  
.PP

.SH
MSR PARAMETERS 
.PP
The \f[B][msr]\f[R] section can contain the following parameter: 
.PP
\f[B]MinimumSmeKernelVersion=5.18.0\f[R] 
.PP
  Minimum kernel version to allow probing for sme flag.  
.PP
  This only needs to be modified by enterprise kernels that have cherry picked the feature into a   kernel with an old version number.  
.PP

.SH
REDFISH PARAMETERS 
.PP
The \f[B][redfish]\f[R] section can contain the following parameters: 
.PP
\f[B]Uri=\f[R] 
.PP
  The URI to the Redfish service in the format \f[B]scheme://ip:port\f[R] for instance \f[B]https://192.168.0.133:443\f[R] 
.PP
\f[B]Username=\f[R] 
.PP
  The username to use when connecting to the Redfish service.  
.PP
\f[B]Password=\f[R] 
.PP
  The password to use when connecting to the Redfish service.  
.PP
\f[B]CACheck=false\f[R] 
.PP
  Whether to verify the server certificate or not. This is turned off by default.    BMCs using self-signed certificates will not work unless the plugin does not verify it against the system CAs.  
.PP
\f[B]IpmiDisableCreateUser=false\f[R] 
.PP
  Do not use IPMI KCS to create an initial user account if no SMBIOS data.    Setting this to \f[B]true\f[R] prevents creating user accounts on the BMC automatically.  
.PP
\f[B]ManagerResetTimeout=1800\f[R] 
.PP
  Amount of time in seconds to wait for a BMC restart.  
.SH
THUNDERBOLT PARAMETERS 
.PP
The \f[B][thunderbolt]\f[R] section can contain the following parameters: 
.PP
\f[B]MinimumKernelVersion=4.13.0\f[R] 
.PP
  Minimum kernel version to allow use of this plugin.  
.PP
  This only needs to be modified by enterprise kernels that have cherry picked the feature into a   kernel with an old version number.  
.PP
\f[B]DelayedActivation=false\f[R] 
.PP
  Forces delaying activation until shutdown/logout/reboot.  
.SH
TEST PARAMETERS 
.PP
The \f[B][test]\f[R] section can contain the following parameters: 
.PP
\f[B]AnotherWriteRequired=\f[R] 
.PP
  Do two passes of the write function.  
.PP
\f[B]CompositeChild=\f[R] 
.PP
  If the device should have a child device.  
.PP
\f[B]DecompressDelay=\f[R] 
.PP
  Delay in milliseconds to use when decompressing the test device.  
.PP
\f[B]NeedsActivation=\f[R] 
.PP
  If the device needs activating before deploying the update.  
.PP
\f[B]NeedsReboot=\f[R] 
.PP
  If the device needs a reboot before deploying the update.  
.PP
\f[B]RegistrationSupported=\f[R] 
.PP
  If the device should register with other plugins.  
.PP
\f[B]RequestDelay=\f[R] 
.PP
  Delay in milliseconds to use when requesting user input from the user.  
.PP
\f[B]RequestSupported=\f[R] 
.PP
  If the device interactive request is supported.  
.PP
\f[B]VerifyDelay=\f[R] 
.PP
  Delay in milliseconds to use when verifying the test device.  
.PP
\f[B]WriteDelay=\f[R] 
.PP
  Delay in milliseconds to use when writing the test device.  
.PP
\f[B]WriteSupported=\f[R] 
.PP
  If the device write is supported. If unsupported the device write will not start.  
.SH
NOTES 
.PP
\f[B]/etc/fwupd/fwupd.conf\f[R] may contain either hardcoded or autogenerated credentials and must only be readable by the user that is running the fwupd process, which is typically \f[B]root\f[R].  
.SH
SEE ALSO 
.PP
<fwupdmgr(1)> <fwupd-remotes.d(5)>