diff --git a/pages/linux/fwupdmgr.md b/pages/linux/fwupdmgr.md
index 6a8b1bf2efc106..7aea3f50b3393d 100644
--- a/pages/linux/fwupdmgr.md
+++ b/pages/linux/fwupdmgr.md
@@ -1,9 +1,10 @@
# fwupdmgr
> Update device firmware, including UEFI, using `fwupd`.
-> More information: .
+> See also: `fwupdtool`.
+> More information: .
-- Display all devices detected by fwupd:
+- Display all devices detected by `fwupd`:
`fwupdmgr get-devices`
@@ -18,3 +19,7 @@
- Install firmware updates:
`fwupdmgr update`
+
+- Remount `/boot` with more privileges if update complains about a read-only filesystem:
+
+`sudo mount {{[-o|--options]}} uid=1000,gid=1000,umask=0022 {{/dev/sdX}} /boot`
diff --git a/pages/linux/fwupdtool.md b/pages/linux/fwupdtool.md
new file mode 100644
index 00000000000000..43070f5af3078b
--- /dev/null
+++ b/pages/linux/fwupdtool.md
@@ -0,0 +1,17 @@
+# fwupdtool
+
+> Update device firmware manually or manipulate firmware files.
+> See also: `fwupdmgr`.
+> More information: .
+
+- Display all devices detected by `fwupd`:
+
+`fwupdtool get-devices`
+
+- Install firmware from a file:
+
+`fwupdtool install {{path/to/firmware}}`
+
+- Display help:
+
+`fwupdtool {{[-h|--help]}}`