Validating the MD5 Checksum of a File

Double-check the integrity of a file through verifying its MD5 checksum

Office supply on office desk table. With copy space.

Utamaru Kido / Getty Images

by Gary Newell
Gary Newell was a freelance contributor, application developer, and software tester with 20+ years in IT, working on Linux, UNIX, and Windows.
Updated November 11, 2019

When you download a large file such as a Linux distribution in the form of an ISO you should validate it to make sure that the file has downloaded properly.

One method that has been used for a number of years is for the developers of software and Linux distributions to provide an ISO, which they send through an encryption method called MD5. This method provides a unique checksum.

The idea is that as a user you can download the ISO and then run a tool which creates an MD5 checksum against that file. The checksum that is returned should match the one located on the website of the software developer.

Downloading a File With an MD5 Checksum

To demonstrate how to validate the checksum of a file you will need a file that already has an MD5 checksum available for it to compare against.

Most Linux distributions provide either an SHA or MD5 checksum for their ISO images. One distribution that uses the MD5 checksum method of validating a file is Bodhi Linux.

You can download a live version of Bodhi Linux from http://www.bodhilinux.com/.

The linked page offers three versions:

  • Standard
  • AppPack Release
  • Legacy Release

Download two files: The Bodhi Linux ISO, available at the download link, and the MD5 file. You'll compare the checksum you see in the MD5 file with the checksum you'll get in a shell session.

  1. Download the ISO itself by clicking on the Download link just under the Standard Release section.

    Screenshot of Download link for Standard Release of Bodhi Linux

  2. Click MD5 to download the MD5 checksum file to your computer. 

    Screenshot of MD5 download link for Standard Release of Bodhi Linux

  3. Open the MD5 file in a text editor. The contents look something like this:

ba411cafee2f0f702572369da0b765e2  bodhi-4.1.0-64.iso

Verify the MD5 Checksum Using Windows

To verify the MD5 checksum:

  1. Screenshot of Windows 10 Command Prompt launch icon

  2. Open your downloads folder by typing cd Downloads. If you saved the files in a different location, go there instead.

    Screenshot of Downloads directory in Windows 10 Command Prompt

  3. Type certutil -hashfile followed by the file name and then MD5.

    Screenshot of

  4. Check that the value returned matches the value the MD5 file you downloaded from the Bodhi website (and opened in Notepad).

    Screenshot comparing hashtag in Command Prompt window with hashtag in Notepad

  5. If the values don't match then the file is not valid and you should download it again.

Verify the MD5 Checksum Using Linux

To verify the MD5 checksum using Linux follow these instructions:

  1. Open a shell session then visit the directory where you downloaded the files.

  2. Enter md5sum followed by the file name.

    Terminal with commands to check md5 in Linux

  3. The value displayed by the md5sum command should match the the value in the MD5 file.

Issues

The md5sum method of checking the validity of a file only works as long as the site you are downloading the software from hasn't been compromised.

In theory, it works well when there are lots of mirrors because you can always check back against the main website.

However, if the main site gets hacked and a link is provided to a new download site and the checksum is changed on the website then you are basically being hoodwinked into downloading something you probably don't want to use.

If the file's checksum doesn't match the value in the supplementary download file, you know that the file was corrupted in some way. Try re-downloading it.