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 files
- FWUPD_SUPPORTEDoverrides the- -Dsupported_buildmeson option at runtime
- FWUPD_VERBOSEis set when running- --verbose
- FWUPD_XMLB_VERBOSEcan be set to show Xmlb silo regeneration and quirk matches
- FWUPD_DBUS_SOCKETis used to set the socket filename if running without a dbus-daemon
- FWUPD_PROFILEcan be used to set the profile traceback threshold value in ms
- FWUPD_EFIVARScan be set to- dummyto emulate an EFI variable store
- FWUPD_FUZZER_RUNNINGif the firmware format is being fuzzed
- FWUPD_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, or- container
- FWUPD_HOST_EMULATEcan be used to load test data from- /usr/share/fwupd/host-emulate.d, e.g.- thinkpad-p1-no-iommu.json.gz
- FWUPD_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 access
- TPM_SERVER_RUNNINGif an emulated TPM is running
- UMOCKDEV_DIRif set, running under umockdev
Other variables, include:
- FWUPD_DELL_FAKE_SMBIOSif set, use fake SMBIOS information for tests
- FWUPD_FORCE_TPM2ignores a TPM 1.2 device detected in the TPM self tests
- FWUPD_REDFISH_SELF_TESTif set, do destructive tests on the actual device BMC
- FWUPD_REDFISH_SMBIOS_DATAuse this filename to emulate a specific SMBIOS blob
- FWUPD_SOLOKEY_EMULATEemulates a fake device for testing
- FWUPD_UEFI_TESTused by the UEFI plugins to disable specific sanity checks during self tests
- FWUPD_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_DIRECTORY
- CONFIGURATION_DIRECTORY
- FWUPD_ACPITABLESDIR
- FWUPD_DATADIR
- FWUPD_DATADIR_QUIRKS
- FWUPD_DATADIR_VENDOR_IDS
- FWUPD_EFIAPPDIR
- FWUPD_FIRMWARESEARCH
- FWUPD_HOSTDIRlooks for host OS- os-releasein this sysroot, default is /
- FWUPD_LIBDIR_PKG
- FWUPD_LOCALSTATEDIR
- FWUPD_LOCALSTATEDIR_QUIRKS
- FWUPD_PROCFS
- FWUPD_SYSCONFDIR
- FWUPD_SYSFSDMIDIR
- FWUPD_SYSFSDRIVERDIR
- FWUPD_SYSFSFWATTRIBDIR
- FWUPD_SYSFSFWDIR
- FWUPD_SYSFSSECURITYDIR
- FWUPD_SYSFSTPMDIR
- FWUPD_LOCKDIR
- FWUPD_UEFI_ESP_PATH
- HOME
- RUNTIME_DIRECTORY
- SNAP
- SNAP_USER_DATA
- STATE_DIRECTORY