Environment Variables
When running fwupd reads some variables from your environment and changes some behavior. This might be useful for debugging, or to make fwupd run somewhere with a non-standard filesystem layout.
fwupdmgr and fwupdtool
DISABLE_SSL_STRICTdisables strict SSL certificate checking, which may make downloading files work when using some antisocial corporate firewalls.FWUPD_CURL_VERBOSEshows more information when downloading filesFWUPD_SUPPORTEDoverrides the-Dsupported_buildmeson option at runtimeFWUPD_VERBOSEis set when running--verboseFWUPD_XMLB_VERBOSEcan be set to show Xmlb silo regeneration and quirk matchesFWUPD_DBUS_SOCKETis used to set the socket filename if running without a dbus-daemonFWUPD_PROFILEcan be used to set the profile traceback threshold value in msFWUPD_EFIVARScan be set todummyto emulate an EFI variable storeFWUPD_FUZZER_RUNNINGif the firmware format is being fuzzedFWUPD_POLKIT_NOCHECKif we should not check for polkit policies to be installed- standard glibc variables like
LANGare also honored for CLI tools that are translated - libcurl respects the session proxy, e.g.
http_proxy,all_proxy,sftp_proxyandno_proxy
daemon
FWUPD_MACHINE_KINDcan be used to override the detected machine type, e.g.physical,virtual, orcontainerFWUPD_HOST_EMULATEcan be used to load test data from/usr/share/fwupd/host-emulate.d, e.g.thinkpad-p1-no-iommu.json.gzFWUPD_SYSCALL_FILTERcan be set to the name of the service manager if syscalls are being filtered, e.g.systemd.
Self Tests
CI_NETWORKif CI is running with network accessTPM_SERVER_RUNNINGif an emulated TPM is runningUMOCKDEV_DIRif set, running under umockdev
Other variables, include:
FWUPD_DELL_FAKE_SMBIOSif set, use fake SMBIOS information for testsFWUPD_FORCE_TPM2ignores a TPM 1.2 device detected in the TPM self testsFWUPD_REDFISH_SELF_TESTif set, do destructive tests on the actual device BMCFWUPD_REDFISH_SMBIOS_DATAuse this filename to emulate a specific SMBIOS blobFWUPD_SOLOKEY_EMULATEemulates a fake device for testingFWUPD_UEFI_TESTused by the UEFI plugins to disable specific sanity checks during self testsFWUPD_MACHINE_IDused by the tests to set a predictable hash normally loaded from/etc/machine-id
File system overrides
These are not fully documented here, see https://github.com/fwupd/fwupd/blob/main/libfwupdplugin/fu-common.c for details.
CACHE_DIRECTORYCONFIGURATION_DIRECTORYFWUPD_ACPITABLESDIRFWUPD_DATADIRFWUPD_DATADIR_QUIRKSFWUPD_DATADIR_VENDOR_IDSFWUPD_EFIAPPDIRFWUPD_FIRMWARESEARCHFWUPD_HOSTDIRlooks for host OSos-releasein this sysroot, default is /FWUPD_LIBDIR_PKGFWUPD_LOCALSTATEDIRFWUPD_LOCALSTATEDIR_QUIRKSFWUPD_PROCFSFWUPD_SYSCONFDIRFWUPD_SYSFSDMIDIRFWUPD_SYSFSDRIVERDIRFWUPD_SYSFSFWATTRIBDIRFWUPD_SYSFSFWDIRFWUPD_SYSFSSECURITYDIRFWUPD_SYSFSTPMDIRFWUPD_LOCKDIRFWUPD_UEFI_ESP_PATHHOMERUNTIME_DIRECTORYSNAPSNAP_USER_DATASTATE_DIRECTORY