fwupdmgr
Manage and update system firmware
TLDR
Display all devices detected by fwupd
Download the latest firmware metadata from LVFS
List the updates available for devices on your system
Install firmware updates
SYNOPSIS
fwupdmgr [OPTIONS] COMMAND [COMMAND OPTIONS]
PARAMETERS
--help
Show help options
--version
Show program version
--verbose
Show verbose debug output
--no-metadata
Skip fetching and using the metadata
--offline
Work offline
refresh
Refresh remote metadata
get-devices
List all devices that can be updated
get-updates
List all available updates
update
Update all supported devices
downgrade
Downgrade all supported devices
get-results
Get results from the last update
cancel
Cancel any pending updates
clear-results
Clear any past results
get-history
Show update history
trust
Trust a metadata file
verify
Verify a firmware file
install
Install a firmware file
get-releases
List available releases for a device
enable-remote
Enable a remote
disable-remote
Disable a remote
DESCRIPTION
fwupdmgr is a command-line tool that allows users to discover, install, and manage firmware updates on Linux-based systems. It interacts with the fwupd daemon, which handles the actual firmware update process. fwupd supports a wide range of devices and firmware types, including system firmware (BIOS/UEFI), device firmware (e.g., SSDs, peripherals), and containerized applications. fwupdmgr provides a user-friendly interface for checking for available updates, listing devices, and initiating firmware installations. The core functionality focuses on providing a consistent and reliable mechanism for keeping device firmware up-to-date, enhancing system security and stability. It's designed to work seamlessly with various Linux distributions and desktop environments.
By default, fwupdmgr uses the Linux Vendor Firmware Service (LVFS), a central repository for firmware updates. However, it can be configured to use other sources.
CAVEATS
The firmware update process can be risky, and a failed update could potentially render a device unusable. It is crucial to ensure that the system has a stable power supply during the update process. Backing up important data before initiating a firmware update is strongly recommended. Some updates may require a system reboot to take effect.
RETURN CODES
fwupdmgr returns 0 on success. Non-zero values indicate failure. Refer to the fwupd documentation for specific error codes and their meanings.
REMOTES
Remotes are sources of firmware metadata. The default remote is the LVFS. fwupdmgr allows enabling and disabling remotes to control the sources of firmware updates. Use 'fwupdmgr enable-remote' and 'fwupdmgr disable-remote' to manage remotes.
HISTORY
fwupdmgr and fwupd were created to address the need for a standardized and secure way to manage firmware updates on Linux. Prior to fwupd, updating firmware on Linux was often a fragmented and vendor-specific process. The project gained significant traction due to its integration with the LVFS, providing a central repository for firmware updates. The development is ongoing, with a focus on expanding device support, improving security, and enhancing the user experience.
SEE ALSO
fwupd(8)