fwupdmgr - Man Page

Firmware update manager client utility



fwupdmgr [OPTIONâ.¦]

activate [DEVICE-ID|GUID]

Activate devices

block-firmware [CHECKSUM]

Blocks a specific firmware from being installed


Erase all firmware update history


Clears any updates scheduled to be updated offline

clear-results DEVICE-ID|GUID

Clears the results from the last update

disable-remote REMOTE-ID

Disables a given remote

downgrade [DEVICE-ID|GUID]

Downgrades the firmware on a device

enable-remote REMOTE-ID

Enables a given remote


Gets the list of approved firmware


Gets the list of blocked firmware

get-details FILE

Gets details about a firmware file


Get all devices that support firmware updates


Show history of firmware updates


Get all enabled plugins registered with the system

get-releases [DEVICE-ID|GUID]

Gets the releases for a device


Gets the configured remotes

get-results DEVICE-ID|GUID

Gets the results from the last update


Alias to get-devices

get-updates [DEVICE-ID|GUID]

Gets the list of updates for connected hardware

get-upgrades [DEVICE-ID|GUID]

Alias to get-updates


Install a firmware file on this hardware

modify-config KEY,VALUE

Modifies a daemon configuration value

modify-remote REMOTE-ID KEY VALUE

Modifies a given remote


Refresh metadata from remote server

reinstall [DEVICE-ID|GUID]

Reinstall current firmware on the device


Share firmware history with the developers


Gets the host security attributes

set-approved-firmware CHECKSUM1[,CHECKSUM2][,CHECKSUM3]

Sets the list of approved firmware

switch-branch [DEVICE-ID|GUID] [BRANCH]

Switch the firmware branch on the device

unblock-firmware [CHECKSUM]

Unblocks a specific firmware from being installed


Unlocks the device for firmware access


Updates all firmware to latest versions available

upgrade [DEVICE-ID|GUID]

Alias to update


Checks cryptographic hash matches firmware

verify-update [DEVICE-ID|GUID]

Update the stored cryptographic hash with current ROM contents

Help Options

-h,  --help

Show help options

Application Options

-v,  --verbose

Show extra debugging information


Show client and daemon versions


Schedule installation for next reboot when possible


Allow reinstalling existing firmware versions


Allow downgrading firmware versions


Allow switching firmware branch


Force the action by relaxing some runtime checks

-y,  --assume-yes

Answer yes to all questions


Sign the uploaded data with the client certificate


Do not check for unreported history


Do not check for old metadata


Do not check if download remotes should be enabled


Do not check for reboot after update


Do not perform device safety checks


Do not write to the history database


Show all results


Ignore SSL strict checks when downloading files


Only use IPFS when downloading files


Filter with a set of device flags using a ~ prefix to exclude, e.g. 'internal,~needs-reboot'


Ignore requirement of external power source

This tool allows an administrator to query and control the fwupd daemon, allowing them to perform actions such as installing or downgrading firmware.


A variety of client tools are provided by fwupd.  Not all tools are suggested to be scripted.

fwupdmgr is a command line fwupd client intended to be used interactively. The output between versions of fwupd is not guaranteed to be stable. Commands that succesfully execute will return "0". Commands that have no actions but succesfully execute will return "2".

fwupdagent is a command line fwupd client intended to be used by scripts. The output is JSON and guaranteed to be stable. Commands that succesfully execute will return "0".


March 2021 fwupdmgr 1.5.7