rpi-imager - Flash disk images to removable storage
rpi-imager |
[--debug] [--repo
url] [--qm
translations]
[--disable-telemetry]
[image-uri] |
rpi-imager |
--cli [--debug]
[--quiet]
[--disable-verify]
[--sha256 expected-hash] image-uri
destination-device |
rpi-imager is a utility for writing a disk image file,
which may optionally be compressed, to a removable destination disk, such as
a micro-SD card or a USB-attached SSD drive.
When run without further command line arguments, the utility
presents a simple graphical interface with controls for image-file
selection, target drive selection, and one to start writing. In this mode,
the Raspberry Pi server (and potentially third party servers) will be
queried for available OS images. You may also specify an image-uri
(which may be a local file, or an HTTP or HTTPS URL) to flash directly on
the command line.
When run with the --cli argument, the utility directly
flashes the image-uri given to the specified
destination-drive. In this case, the --sha256 option can be
used to pass in the expected SHA256 checksum of the image.
- --cli
- Do not launch the graphical interface; just flash the image given to the
specified drive. In this mode, the image-uri and
destination-device must both be specified.
- --debug
- Output extra debugging information on the console.
- --disable-telemetry
- Do not report OS writes to
http://rpi-imager-stats.raspberrypi.com/
- --disable-verify
- After writing the image, do not attempt to verify that the image was
written correctly. Only valid when run with --cli.
- --help
- Display a synopsis of the command line syntax and exit.
- --quiet
- Suppress all console output. Only valid when run with --cli.
- --qm translations
- Specify an alternate Qt message translations file to use with the
GUI.
- --repo url
- Instead of querying the Raspberry Pi servers for the list of available OS
images, query this URL instead. The URL will be expected to return a JSON
file conforming to the format described in the associated
json-schema.
- --sha256 expected-hash
- Verify that the image matches the expected-hash before writing it
to the specified destination. Only valid when run with --cli.
- --version
- Report the version of the utility, and the default URI it will attempt to
query to determine the available OS images.
- image-uri
- If specified, the URI of the image to write to the destination. This may
be a local file, or a remote URL supporting the HTTP or HTTPS protocols.
This must be specified when using --cli.
- destination-device
- The device to which to write the specified image, e.g.
/dev/mmcblk0. Only valid when run with --cli.