Skip to content

Commit 0b55b2b

Browse files
committed
feat: add iso-testing section
1 parent 27545ac commit 0b55b2b

2 files changed

Lines changed: 60 additions & 1 deletion

File tree

docs/guides/iso-testing.md

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
---
2+
title: ISO Testing
3+
description: Aurora ISO testing
4+
---
5+
6+
Our ISO testing program is an easy way to contribute back to the project. We plan to refresh these ISO images every firts of the month. If you find issues, please raise on github issue on the [ISO repo](https://github.com/get-aurora-dev/iso).
7+
8+
## Things to Test For
9+
10+
- Installation experience
11+
- Secure Boot
12+
- Bare metal if possible but not required
13+
- If you've got the time, go through the docs and run through the new user experience. These bugs are highly prized, so if you find one, file it!
14+
15+
## Aurora
16+
17+
| Version | GPU | Download | Checksum |
18+
| ------- | --------- | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- |
19+
| Aurora | AMD/Intel | [📥 aurora-stable-webui-x86_64.iso](https://dl-test.getaurora.dev/aurora-stable-webui-x86_64.iso) | [🔐 Verify](https://dl-test.getaurora.dev/aurora-stable-webui-x86_64.iso-CHECKSUM) |
20+
| Aurora | Nvidia | [📥 aurora-nvidia-open-stable-webui-x86_64.iso](https://dl-test.getaurora.dev/aurora-nvidia-open-stable-webui-x86_64.iso) | [🔐 Verify](https://dl-test.getaurora.dev/aurora-nvidia-open-stable-webui-x86_64.iso-CHECKSUM) |
21+
22+
## Verifying Downloads with Checksums
23+
24+
**Checksums** allow you to verify that your download completed successfully and wasn't corrupted or tampered with. After downloading an ISO, you can compare its checksum to the official checksum file to ensure integrity. While optional, verification is recommended for important installations.
25+
26+
#### How to verify checksums using sha256sum
27+
28+
1. **Download both the ISO file and its corresponding CHECKSUM file**
29+
- For example: `aurora-stable-webui-x86_64.iso` and `aurora-stable-webui-x86_64.iso-CHECKSUM`
30+
31+
2. **Generate the checksum of your downloaded ISO:**
32+
33+
```bash
34+
sha256sum aurora-stable-webui-x86_64.iso
35+
```
36+
37+
3. **Compare with the official checksum file:**
38+
39+
```bash
40+
cat aurora-stable-webui-x86_64.iso-CHECKSUM
41+
```
42+
43+
4. **Verify they match:** The output from step 2 should match the hash in the CHECKSUM file. If they match, your download is verified and safe to use.
44+
45+
**Example:**
46+
47+
```bash
48+
# Generate checksum of downloaded file
49+
$ sha256sum aurora-stable-webui-x86_64.iso
50+
a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456 aurora-stable-webui-x86_64.iso
51+
52+
# Check official checksum
53+
$ cat aurora-stable-webui-x86_64.iso-CHECKSUM
54+
a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456 aurora-stable-webui-x86_64.iso
55+
56+
```

sidebars.ts

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,10 @@ const sidebars: SidebarsConfig = {
7676
type: "category",
7777
label: "Contributing",
7878
collapsed: false,
79-
items: ["guides/building"],
79+
items: [
80+
"guides/building",
81+
"guides/iso-testing",
82+
],
8083
},
8184
],
8285
};

0 commit comments

Comments
 (0)