How do I use an .img.xz file or get an .img file from it?

I have a file with an xz extension, ubuntu-19.10-preinstalled-server-arm64+raspi3.img.xz. How do you get the .img out of it?

My goal is to flash the file on an SD card. I want to use www.etcher.io I finally got it to work, but etcher will only handle .iso and .img files.


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 of unxz. If you have a corrupted file, xzcat will fail, just as unxz would.

    If you ran unxz and got a .img file, then don't use that command above with xzcat. 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.