site  news  contact

How to write EasyOS to a flash drive

September 06, 2019 — BarryK

Page originally created October 9, 2017, updated December 9, 2018,
August 25, 2019, September 6, 2019

EasyOS is a Linux distribution deployed as an image-file that may be written to a USB Flash drive, then booted. There are two aspects to this:

  1. After having downloaded the image-file, how do you write it to a USB Flash stick?
  2. How do you get the computer to "boot" (startup EasyOS) from the USB drive?

The answers to both of these questions are quite simple. This web page answers question-1. At the bottom of this page, there is a link to another page that answers question-2.

Ha ha, the pages cascade... that next page has a link to a third tutorial, that explains how to install Easy to the internal drive of a computer, and dual-boot with Windows. You might not want to go that far, but telling you now, so that you know that the option is there, in case you do.

This web page is in two halves, depending on whether you are currently running Windows or Linux. Each has its own tools for writing the image file to a Flash drive. Firstly though, you need to download the EasyOS image-file...

Download Easy

Go to the primary hosting site, here:

...and download the latest version. It is a file named easy-*-amd64.img.gz, where that "*" is the version number. That ".gz" on the end of the filename means that it is compressed with the gzip format.

You could just assume that it downloaded correctly, but if you want to be sure, you will see a file named md5sums.txt or easy-*-.img.gx.md5.txt on the website, alongside easy-*-amd64.img.gz.
Download that too, or look at its contents online.

One thing that is a good idea, is to read Barry's blog announcements. There will be useful news about the latest release. Browse the EasyOS news here:

Having downloaded the file, you now need to write it to a USB Flash stick. As stated, it depends whether you are currently running Windows or Linux. Jump to which section applies...


If you want to be certain that the downloaded file is not corrupted, do this: open a terminal window at the same folder where you downloaded easy-*-amd64.img.gz (any file manager worth its salt will have an "Open terminal here" menu item). Then run (for the example of version 0.9.12):

# md5sum easy-0.9.12-amd64.img.gz

Then, if you are a wiz on the Linux commandline, you might be able to just run a command like this (assuming Easy version 0.9.12, and the USB Flash drive is sdb):

# gunzip --stdout easy-0.9.12-amd64.img.gz | dd of=/dev/sdb bs=1M
# sync

For everyone else, and even if you are a Linux-wiz, it is recommended that you use one of the nice GUI tools available. A superb free cross-platform (Linux and Windows) GUI tool is Etcher, a favourite of the Raspberry Pi users. Download from here:

 Another Linux tool is the EasyDD utility, that may be run in a terminal on the commandline, or as a GUI. Even if you like to use the commandline in Linux, it is good to use EasyDD rather than the method shown above, as EasyDD helps to choose the correct target-drive, and does a lot of sanity checking. Even wiz's can make dumb mistakes!

EasyDD verifies writes
A good reason to choose EasyDD is that it now does two-stage verification. Firstly, the inverse of the image file (all bits flipped) is written to the drive, then read back to verify. Secondly, the actual image file is written, then verified. This verification has limited usefulness with SSDs, that have error correction in hardware, however likely to be very useful with cheap Flash sticks.

EasyDD is in EasyOS, however, as you are not yet running Easy, you will have to download this utility. It is a script named easydd, and should work in almost every Linux distribution.

Get it from here:

Open a terminal window at the same folder where you downloaded easy-*-amd64.img.gz , if not already.

Then, download easydd.gz to the same folder, and run this;

# gunzip easydd.gz
# chmod 755 easydd

...the first line uncompresses the file, the second line makes it executable.

EasyDD can run as a fully-GUI application, or in CLI-mode. CLI means Command Line Interface, and this is the one you will use. The GUI mode is nice, but it is likely that whatever Linux distribution you are currently using, does not have the required dependencies.

Here is a summary of how to run EasyDD:

# easydd
No parameters, runs in GUI mode
# easydd <file>
image-file parameter, will ask for target-drive
# easydd <file> <drive>
image-file and target-drive parameters
# easydd -h
Prints help info. Long option "--help"

An example of row-3 is "easydd easy-0.9.12-amd64.img.gz sdb", however, to minimize the possibility of choosing the wrong target drive, it is recommended that you choose row-2. Example:

# ./easydd easy-0.9.12-amd64.img.gz

...notice the "./" prefix. You need that, because easydd is in the current directory. Note also, the "#" -- you don't type that, it is the shell prompt, and may be different in your Linux distro.

Do it as root
If you are running Puppy Linux or derivative, you will be logged in as the administrator, "root". Ditto for EasyOS. Other Linux distributions may require you to bump up to root, by running "su" or "sudo", before they will allow you to use easydd.

Next, you will be asked to plugin the Flash drive, then you choose it, then you write the file to it. It is very simple.

What size drive?
When EasyDD asks you to plugin a Flash drive, and you rummage around looking for one, choose 8GB or bigger. Well, 4GB will work, even 2GB, but only for an initial evaluation -- you will need more space for ongoing usage.

You are now ready to boot the computer from the Flash drive. Jump down to the bottom of this page for the link to the next tutorial.


There are various free Windows tools for writing a compressed image file to a Flash stick, including Etcher and USB Image Tool. Etcher is cross-platform and works on Linux and Windows, and is very popular with Raspberry Pi users. Get Etcher from here:

The Author has tested is USB Image Tool, and usage instructions are given below.

USB Image Tool website:

Before launching into a description of how to use USB Image Tool, it is a very good idea to check that easy-*-amd64.img.gz was properly downloaded. There is a tool for doing this:

Unzip it, and extract md5sums.exe (usually achieved by right-click, then choose to extract contents). The usage instructions explain that if you drag easy-*-amd64.img.gz on top of md5sums.exe, it will display the md5sum hash-code. You can check this against the content of the online md5sums.txt file, to verify that the file was downloaded correctly.
This is optional, but usually a good thing to do.

USB Image Tool does not have an installer, it is just a zip file that you extract the files from wherever you want them. That is, download, to say, the "Download" folder, then copy wherever you want it, then right-click on it and choose to extract the contents. When you do so, you will see these files:


The one that you need to run is "USB Image Tool.exe" -- right-click on it and choose "Run as administrator".

If your USB Flash stick is already plugged in, you will see it on the left side. Otherwise, plug it in and it should appear (see the note in the Linux section, use a drive 2GB or greater, prefer 8GB for ongoing usage). Notice at the top, "Device mode" is selected, this is important:


Click on the Flash drive to highlight it, then click the "Restore" button. You should have downloaded the image file beforehand, now choose it:


Easy, just highlight the *.img.gz file (whichever you have downloaded) then click the "Open" button. Then just watch as the file is uncompressed and written to the drive:


One thing to be careful about. Looking at the above snapshot, you might think it reasonable that writing is finished when it reaches "100%". Not so, it actually went to almost "300%" before finishing. So wait until the green bar goes away entirely.

Do not yet unplug the Flash stick! It is now ready to use, however, with Windows you must first select "Safely eject drives" from the tray:


This ensures that Windows has fully flushed everything to the drive. If you just pull out the drive without doing this, it is possible the tail-end of the write operation was not fully written to the drive, even if you have finished and exited from USB Image Tool.
In the example shown above, the Flash drive that is plugged-in is named "Data Traveler 2.0". There is also an SD-card inserted.

How to boot from the Flash drive on your computer

Easy has been written to the Flash drive, and you are eager to try it. There are simple steps to follow, to tell your computer to recognise the plugged-in Flash drive at power-on, and boot up the operating system on that drive.

Note that this can be done non-invasively, so it won't upset the installation of Windows or other OS on the computer's hard drive, and you will be able to easily go back to booting it/them.

So, here is the next tutorial:

Have fun!

(c) Copyright Barry Kauler, December 2018. All reproduction rights reserved.
Disclaimer: Information is provided "in good faith", however the author accepts no liability whatsoever, and you apply the instructions on this page, and subsequent tutorial pages, with this understanding. 

Tags: install