Skip to content

feat: add guide for verifying Windows ISO integrity #258

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Mar 28, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 36 additions & 0 deletions docs/general-faq/verify-iso-integrity.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
---
description: How to verify the integrity of your Windows ISO for AtlasOS installation
icon: material/check-decagram
---

# :material-check-decagram: How do I verify the integrity of my Windows ISO?

**A damaged or altered ISO file can lead to installation errors like random BSODs, application crashes, or unstable system behavior. This guide will help you verify your Windows ISO file before proceeding with your installation.**

## :material-information: Why Verify?

Verifying your ISO ensures:
- **Completeness:** The file is fully downloaded and unaltered.
- **Reliability:** Avoids mysterious errors during or after installation.
- **Consistency:** Confirms the file's integrity, especially if downloaded more than once.

## :material-console: How to Verify Your ISO

### **On Windows**
1. Open **Command Prompt as Administrator**.
2. Run the following command (replace `<path_to_iso>` with the actual path to your ISO file):
```cmd
certutil -hashfile <path_to_iso> SHA256
```
3. Download the ISO file twice from the same source.
Compare the hash values of both downloads using the command provided above.
If the hash values match, your ISO file is intact and safe to use. If they do not match, try downloading the file again and repeat the verification process.

## :material-alert: Note

Due to the large number of language editions available, we do not list individual hash values for each variant. Instead, verify your download’s consistency by comparing checksums from separate downloads if you suspect any issues.

## :material-check-circle-outline: Next Steps

Once you have confirmed the ISO’s integrity, proceed to burn the ISO to a disk or create a bootable USB drive and continue with your Windows installation and AtlasOS setup.

1 change: 1 addition & 0 deletions mkdocs.insiders.yml
Original file line number Diff line number Diff line change
Expand Up @@ -78,6 +78,7 @@ plugins:
'faq-and-troubleshooting/common-questions/microsoft-store.md': 'general-faq/microsoft-store.md'
'faq-and-troubleshooting/common-questions/roblox-not-opening.md': 'general-faq/roblox-not-opening.md'
'faq-and-troubleshooting/common-questions/fifa-and-eafc-not-launching.md': 'general-faq/fifa-and-eafc-not-launching.md'
'faq-and-troubleshooting/common-questions/verify-iso-integrity.md': 'general-faq/verify-iso-integrity.md'

# 'Troubleshooting' moved to Atlas Configuration
'faq-and-troubleshooting/common-questions/atlas-folder-scripts.md': 'getting-started/post-installation/atlas-folder/troubleshooting.md'
Expand Down
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -87,6 +87,7 @@ nav:
- Roblox not launching: general-faq/roblox-not-launching.md
- FIFA/EAFC not launching: general-faq/fifa-and-eafc-not-launching.md
- Shortcuts show up as .url files: general-faq/game-url-files.md
- Verify ISO integrity: general-faq/verify-iso-integrity.md

- Development:
- Contribution Guidelines: contributing/contribution-guidelines.md
Expand Down