Skip to content
Atlas
Skip to Content
Get started

Download and check

Download the Atlas image and check that it is intact and genuine (SHA-256 and signature).

Download

Go to the site's Download page and read the notice at the top: this is a testing build. The Download the ISO button gives a file named atlas-0.1-testing-amd64.iso. It comes straight from our storage, and can be big: give it time.

Next to the image the page also gives its size and SHA-256, and three links you need for checking: SHA256SUMS, SHA256SUMS.asc and the public signing key (atlas-release-key.asc).

Why check

Two reasons: a download can be incomplete or damaged, and a file taken anywhere but our site could have been changed. Every image is listed with its SHA-256 in a file named SHA256SUMS, and that file is signed with the Atlas release signing key. Check the checksum, and the signature too if you can.

1. The checksum (SHA-256)

Open a terminal in the folder where the image is (often Downloads).

On Windows (Command Prompt or PowerShell):

certutil -hashfile atlas-0.1-testing-amd64.iso SHA256

On Linux:

sha256sum atlas-0.1-testing-amd64.iso

The long 64-character string it prints must be identical to the SHA-256 on the Download page, and to the image's line in SHA256SUMS. If there is the smallest difference, delete the file and download it again.

2. The signature

The signature proves that SHA256SUMS really comes from Atlas. You need GnuPG (gpg): it is on most Linux systems; on Windows, install Gpg4win, for example.

Download SHA256SUMS, SHA256SUMS.asc and atlas-release-key.asc into the same folder, then run:

gpg --import atlas-release-key.asc
gpg --verify SHA256SUMS.asc SHA256SUMS

Look for the line Good signature from "Atlas Release Signing Key", and the key's fingerprint:

3DC6 9287 3B99 7F99 0949 8FD9 8BAF 9694 DF1E 138D

A warning that the key is not certified is normal: you have not yet told GnuPG that you trust it. What matters is "Good signature" and the fingerprint above, the same as on the Download page.

If the signature is bad (BAD signature), or the fingerprint is different, do not use the file.

Next step: write it to a USB stick.