How do I use an .img.xz file or get an .img file from it?
xz is a compression format like zip or gz. To be able to decompress it from the command line you need to install xz-utils:
$ sudo apt-get install xz-utils
and then use this command to decompress your file:
$ unxz ubuntu-19.10-preinstalled-server-arm64+raspi3.img.xz
If you are under windows you can use 7zip
Decompressing .xz
files in general
ubuntu-19.10-preinstalled-server-arm64+raspi3.img.xz
is the result of compressing a single file, ubuntu-19.10-preinstalled-server-arm64+raspi3.img
, with xz
. You can uncompress it with:
unxz ubuntu-19.10-preinstalled-server-arm64+raspi3.img.xz
That will extract ubuntu-19.10-preinstalled-server-arm64+raspi3.img
and, assuming it succeeds, delete ubuntu-19.10-preinstalled-server-arm64+raspi3.img.xz
. If you want to keep that original .xz
file, you can pass the -k
/--keep
option:
unxz -k ubuntu-19.10-preinstalled-server-arm64+raspi3.img.xz
Note that this is different from what you would usually do for a .tar.xz
file, since tar
supports decompressing and extraction through a single command. In the case of a .xz
file (unless the file is very misleadingly named), only decompression is needed.
Flashing the preinstalled Ubuntu Server image in particular
The particular file you've downloaded is a preinstalled image for Ubuntu Server 19.10. Assuming the file was correctly and successfully downloaded (see below), you can use the official instructions to flash this image to a storage device. The best way to do this differs depending on what operating system you're using to do it. But assuming it's Ubuntu, here's a summary:
Find the name of the device that you are writing it to. One way to do this is in Disks (your file browser). Make sure this is not the name of a device that contains any data you wish to keep!
Run this command, replacing
device
with the device name you found:xzcat ubuntu-19.10-preinstalled-server-arm64+raspi3.img.xz | sudo dd of=device bs=32M
There,
xzcat
is doing the work ofunxz
. If you have a corrupted file,xzcat
will fail, just asunxz
would.If you ran
unxz
and got a.img
file, then don't use that command above withxzcat
. In that case, use this command instead:sudo dd if=ubuntu-19.10-preinstalled-server-arm64+raspi3.img.xz of=device bs=32M
It is not typically possible to write a flash drive with dd
in a WSL system. So if you're running Ubuntu in Windows 10 with WSL, those instructions don't apply. But in that case you can just use a Windows method (see the official instructions).
Dealing with possibly incomplete or corrupted files
If decompression fails with an error message about how the file format is not recognized, then especially if running file
on it is unable to identify the format as XZ compressed data
(though sometimes otherwise), you likely have a corrupted or incomplete download. You can use ls -l
to find the length of your file in bytes and compare that length to the expected length--for that particular file, the length should be 661217868. That addresses most cases of incomplete downloads and a few cases of corrupted downloads, but it is far from perfect.
Many files available for downloading, including ubuntu-19.10-preinstalled-server-arm64+raspi3.img.xz
all the Ubuntu images, have checksums that can be used to more reliably gauge if the file was completely and correctly downloaded. For security purposes, it's a good idea to check the GPG signautre on the file providing the checksums (and to avoid MD5 checksums, which are weak against deliberate attacks). But for checking for inadvertent corruption, it's enough to look up the checksum and test your file.
The kind of checksum provided and recommended for checking Ubuntu images these days is a SHA256SUM. This file contains the SHA256SUMs for the 19.10 server images, including ubuntu-19.10-preinstalled-server-arm64+raspi3.img.xz
. One of its lines is:
52ca28f21685eef965d476a716a7bc01237456d6a8770a56630299036eade0bf *ubuntu-19.10-preinstalled-server-arm64+raspi3.img.xz
Running the sha256sum
utility on your file should produce a checksum that matches exactly, like this:
$ sha256sum ubuntu-19.10-preinstalled-server-arm64+raspi3.img.xz
52ca28f21685eef965d476a716a7bc01237456d6a8770a56630299036eade0bf ubuntu-19.10-preinstalled-server-arm64+raspi3.img.xz
If it does not, then your download was corrupted or incomplete and that's probably the explanation for your difficulty decompressing or otherwise using the file.
As far I can see on my Ubuntu 16.04 LTS system - the GNOME Disks utility allow to restore disk image in GUI way:
- Select target drive.
Click on hamburger button, and then select Restore Disk Image
Then it will ask the path of image file:
here you can select any of *.img, *.img.xz (sic!) and *.iso formats.
Double check that destination is correct and then hit Start Restoring... button on opened window.