LinuxCommandLibrary

fwupdmgr

Manage and update system firmware

TLDR

Display all devices detected by fwupd

$ fwupdmgr get-devices
copy

Download the latest firmware metadata from LVFS
$ fwupdmgr refresh
copy

List the updates available for devices on your system
$ fwupdmgr get-updates
copy

Install firmware updates
$ fwupdmgr update
copy

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)

Copied to clipboard