Skip to content

Commit ac87ec8

Browse files
jacksyrmCopilot
jacksyrm
and
Copilot
authored
Update/Add Documentation Based on Common User Questions (#261)
* feat: add Windows 10 vs 11 guidance for AtlasOS users * fix: update title for AtlasOS security documentation * feat: add guide for enabling TPM 2.0 for Windows 11 installation * feat: add documentation for checking AtlasOS version with new images * feat: add installation data loss FAQ for AtlasOS users * feat: add FAQ on resetting AtlasOS and correct procedures * feat: add FAQ on using Microsoft accounts with AtlasOS * feat: add FAQ on upgrading Windows version with AtlasOS installed * feat: add note to link to newly created page * feat: update AtlasOS update guide with new information and clarity on version compatibility * feat: add new entries and organise layout * Update docs/getting-started/installation.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
1 parent c61f259 commit ac87ec8

13 files changed

+316
-22
lines changed

‎docs/assets/images/windows-settings-atlas-version.png‎

52 KB
Loading

‎docs/assets/images/winver-atlas-version.png‎

17.9 KB
Loading

‎docs/general-faq/atlas-and-security.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ description: How secure is AtlasOS?
33
icon: material/shield
44
---
55

6-
# :material-shield: How secure is Atlas?
6+
# :material-shield: How secure is AtlasOS?
77

88
**Atlas aims to be as secure as you want, including the ability to toggle Windows Defender, [mitigations](../getting-started/post-installation/atlas-folder/security.md#mitigations), and automatic Windows updates freely.**
99

‎docs/general-faq/checking-atlas-version.md‎

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
---
2+
description: How to check which version of AtlasOS you have installed.
3+
icon: material/information-outline
4+
---
5+
6+
# :material-information-outline: Checking Your AtlasOS Version
7+
8+
Knowing which version of AtlasOS you have installed is important, especially when considering updates or troubleshooting. As mentioned in our [Updating AtlasOS guide](./updating-atlas.md), different versions have different update paths and support levels.
9+
10+
There are two primary ways to check your installed Windows version, which corresponds to your AtlasOS version:
11+
12+
## 1. Using the `winver` Command
13+
14+
This is a quick way to see your Windows build number and the Atlas Playbook version.
15+
16+
1. Press ++win+r++ on your keyboard to open the Run dialog.
17+
2. Type `winver` and press Enter or click OK.
18+
3. A window will appear showing your Windows version and OS Build number. Below the user name, you should also see the **Atlas Playbook version** installed (e.g., `Atlas Playbook v0.4.1`).
19+
20+
<figure markdown="span">
21+
![Winver dialog showing Atlas Playbook version](../assets/images/winver-atlas-version.png)
22+
<figcaption>Atlas Playbook v0.4.1 shown in the winver dialog</figcaption>
23+
</figure>
24+
25+
## 2. Using Windows Settings
26+
27+
You can also find detailed system information, including the Atlas Playbook version, in the Settings app.
28+
29+
1. Open Windows Settings (you can press ++win+i++).
30+
2. Navigate to `System`.
31+
3. Click on `About`.
32+
4. Look directly under your PC's name (e.g., `DESKTOP-PDSCPN3`). You should see the **Atlas Playbook version** listed there (e.g., `Atlas Playbook v0.4.1`).
33+
5. Further down, under the "Windows specifications" section, you'll find the base Windows Edition (e.g., Windows 11 Pro) and the Version number (e.g., 22H2).
34+
35+
<figure markdown="span">
36+
![Windows Settings About page showing Atlas Playbook version under the device name](../assets/images/windows-settings-atlas-version.png)
37+
<figcaption>Atlas Playbook v0.4.1 shown in the Windows Settings About page</figcaption>
38+
</figure>
39+
40+
By checking the **Atlas Playbook version** using either of these methods, you can easily identify your installed release, helping you follow the correct [update procedures](./updating-atlas.md) or seek appropriate support.

‎docs/general-faq/enabling-tpm.md‎

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
---
2+
title: Enabling TPM 2.0 for Windows 11 Installation
3+
description: How to enable the Trusted Platform Module (TPM) in your system's BIOS/UEFI, a requirement for Windows 11.
4+
icon: material/chip
5+
---
6+
7+
# :material-chip: Enabling TPM 2.0 for Windows 11 Installation
8+
9+
Windows 11 has specific system requirements, including the need for **Trusted Platform Module (TPM) version 2.0** to be enabled on your system. If you are trying to install Windows 11 (as part of the AtlasOS installation process) and encounter an error stating your PC doesn't meet the requirements, you may need to enable TPM in your system's BIOS or UEFI settings.
10+
11+
TPM is a security feature built into modern motherboards or CPUs that provides hardware-based security functions.
12+
13+
!!! warning "Proceed with Caution"
14+
Modifying BIOS/UEFI settings incorrectly can potentially cause system instability. While enabling TPM is generally safe, only change settings you understand. If unsure, consult your motherboard or computer manufacturer's documentation.
15+
16+
## Step 1: Accessing BIOS/UEFI
17+
18+
You need to restart your computer and enter the BIOS/UEFI setup utility before Windows starts loading.
19+
20+
1. **Restart your computer.**
21+
2. **Immediately press the BIOS/UEFI entry key repeatedly** as the system powers on. Common keys include:
22+
* `DEL` (Delete)
23+
* `F2`
24+
* `F10`
25+
* `F12`
26+
* `ESC` (Escape)
27+
* The correct key often briefly appears on the screen during startup (e.g., "Press DEL to enter Setup"). If unsure, check your computer or motherboard manual, or search online for your specific model.
28+
29+
## Step 2: Finding the TPM Setting
30+
31+
BIOS/UEFI interfaces vary significantly between manufacturers (ASUS, Gigabyte, MSI, Dell, HP, Lenovo, etc.) and even between models. You will need to navigate through the menus to find the relevant setting.
32+
33+
* **Look for sections named:**
34+
* `Security`
35+
* `Advanced`
36+
* `Trusted Computing`
37+
* `Peripherals`
38+
* `CPU Configuration`
39+
40+
* **Look for setting names like:**
41+
* `TPM` / `TPM Device` / `TPM Support` / `TPM State`
42+
* `Security Device` / `Security Device Support`
43+
* **For Intel CPUs:** `PTT` (Platform Trust Technology) or `Intel PTT`
44+
* **For AMD CPUs:** `fTPM` (Firmware TPM) or `AMD fTPM switch` / `CPU fTPM`
45+
46+
!!! tip "Can't find it?"
47+
Sometimes the setting might be nested under another option (e.g., under `Advanced\PCH-FW Configuration` for some Intel systems). Refer to your motherboard/PC manual or manufacturer's support website for specific guidance. If the option seems entirely missing, ensure your BIOS/UEFI is up-to-date, but be aware BIOS updates carry risks.
48+
49+
## Step 3: Enabling TPM
50+
51+
Once you find the setting:
52+
53+
1. Select the TPM (or equivalent, like PTT/fTPM) option.
54+
2. Change its value from `Disabled` / `Off` / `Hidden` to `Enabled` / `On` / `Available` / `Firmware TPM`.
55+
* *Note:* Sometimes there are separate options for the TPM state and device visibility. Ensure the device itself is enabled or activated.
56+
57+
## Step 4: Saving Changes and Exiting
58+
59+
1. Navigate to the `Exit` section of your BIOS/UEFI.
60+
2. Select the option to **Save Changes and Exit** (often `F10` key followed by `Y` or `Enter` to confirm). Common menu names are `Save & Exit Setup`, `Exit Saving Changes`.
61+
3. Your computer will restart.
62+
63+
## Step 5: Retry Windows Installation
64+
65+
After your computer restarts, attempt the Windows 11 installation step from the [Atlas Installation Guide](../getting-started/installation.md) again. The requirements check should now pass if TPM was the only issue.
66+
67+
If you continue to have problems, double-check your BIOS/UEFI settings and consult your hardware manufacturer's documentation.

‎docs/general-faq/installation-data-loss.md‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
description: Do I need to reinstall Windows or lose my data to install AtlasOS?
3+
icon: material/database-arrow-down-outline
4+
---
5+
6+
# :material-database-arrow-down-outline: Installing AtlasOS, Fresh Install & Data Loss
7+
8+
Many users ask if they need to perform a fresh Windows installation or if their personal data will be lost when applying AtlasOS. Here's a breakdown:
9+
10+
## :material-help-circle-outline: Do I need to reinstall Windows?
11+
12+
**Yes, a fresh/clean installation of Windows is required for a stable and functional AtlasOS experience.**
13+
14+
Attempting to apply AtlasOS on an existing, non-fresh Windows installation **will cause system instability, failed optimizations, broken features, and leave your system in an unsupported state.** It is not a viable alternative to a clean install.
15+
16+
For a working and supported AtlasOS system, you **must**:
17+
1. Perform a clean installation of a compatible Windows version.
18+
2. Apply the Atlas playbook immediately after the Windows setup.
19+
20+
[:link: Refer to the Installation Guide for supported Windows versions and steps](../getting-started/installation.md)
21+
22+
## :material-file-document-outline: Will I lose my personal files and data?
23+
24+
**No.** Applying AtlasOS **does not** intentionally delete your personal files, documents, photos, games, or other user data stored on your drives. The process focuses on modifying Windows system settings, services, and components.
25+
26+
However, some Windows features or built-in apps that Atlas removes might be associated with specific data *within those apps*. If you rely heavily on a feature Atlas removes, ensure you have alternatives or backups for that specific data.
27+
28+
## :material-microsoft-windows: Do I need Windows installed first?
29+
30+
**Yes.** AtlasOS is a modification applied on top of Windows; it is **not** a standalone operating system.
31+
32+
If you are asking this question, it means you have **not** read or followed the **official Atlas Installation Guide**. Following this guide precisely is **mandatory** for a successful and supported installation. It covers all prerequisites, including the requirement to have a compatible version of Windows installed first.
33+
34+
**Do not proceed further without consulting the guide:**
35+
36+
[:link: Atlas Installation Guide](../getting-started/installation.md)

‎docs/general-faq/microsoft-account-usage.md‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
description: Can I use my Microsoft account with AtlasOS or the Microsoft Store?
3+
icon: material/account-circle-outline
4+
---
5+
6+
# :material-account-circle-outline: Using Your Microsoft Account with AtlasOS
7+
8+
A common question is whether you can or should use your Microsoft account with AtlasOS. Here's the breakdown:
9+
10+
## :material-store: Microsoft Store and Apps
11+
12+
**Yes, you can sign in with your Microsoft account within the Microsoft Store** or within specific applications (like the Xbox app) that require it.
13+
14+
This allows you to:
15+
16+
* Install apps you own.
17+
* Access subscriptions linked to your account (like Game Pass).
18+
* Sync progress in certain games or apps.
19+
20+
Signing into the Store or individual apps does **not** require you to use a Microsoft account for your main Windows login.
21+
22+
## :material-account-off-outline: Windows User Account (Login)
23+
24+
While you *can* technically use a Microsoft account to sign in to Windows itself on AtlasOS, **we strongly recommend using a local account instead for privacy reasons.**
25+
26+
* **Why a local account?** AtlasOS aims to minimize data collection and telemetry sent to Microsoft. Using a local account is a key step in achieving this, as it avoids directly linking your device usage and diagnostics to your personal Microsoft account profile. Microsoft accounts inherently involve more data synchronization and potential tracking compared to offline, local accounts.
27+
* **Functionality:** You can still access most Windows features and install software using a local account. Signing into specific apps (like the Store, as mentioned above) is separate from your main Windows login.
28+
29+
**In summary:** Feel free to use your Microsoft account where needed *within* apps like the Microsoft Store, but stick to a local account for your main Windows user profile to align with our privacy-focused goals.

‎docs/general-faq/resetting-atlas.md‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
description: Explains why the standard Windows 'Reset this PC' feature doesn't work with AtlasOS and details the correct procedure.
3+
icon: material/backup-restore
4+
---
5+
6+
# :material-backup-restore: Resetting or Reinstalling AtlasOS
7+
8+
A common question is how to "reset" a PC running AtlasOS, perhaps to start fresh or fix persistent issues. It's crucial to understand that using the standard Windows "Reset this PC" feature is **not the correct method and will likely cause problems.**
9+
10+
## :material-alert-circle-outline: Why Standard Windows Reset Fails
11+
12+
AtlasOS makes deep changes to the standard Windows installation. Because of these modifications, the built-in **"Reset this PC" feature does not work correctly** with AtlasOS. It is designed for standard Windows systems and cannot handle the changes Atlas applies.
13+
14+
Attempting to use "Reset this PC" will likely fail or leave your system in a broken, inconsistent, and unsupported state.
15+
16+
**Do NOT use the standard Windows "Reset this PC" option.**
17+
18+
## :material-tools: The Correct Way to "Reset" or Reinstall AtlasOS
19+
20+
If you want to start fresh with AtlasOS (effectively "resetting" your Atlas installation), the **only supported and recommended method** is to perform a clean installation following the official Atlas Installation Guide.
21+
22+
**Before you begin, make sure to back up any important personal data**, as this process involves reinstalling Windows and will wipe your system drive.
23+
24+
**Follow the official Installation Guide for detailed steps:**
25+
26+
[:link: Atlas Installation Guide](../getting-started/installation.md)
27+
28+
## :material-undo-variant: Just Want to Remove Atlas?
29+
30+
If your goal is simply to return to a standard version of Windows without AtlasOS, you should follow the guide for reverting Atlas, which also involves a clean Windows installation.
31+
32+
[:link: Reverting Atlas Guide](../getting-started/reverting-atlas.md)

‎docs/general-faq/updating-atlas.md‎

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,11 @@ description: How do I update AtlasOS to the latest version?
33
icon: material/microsoft-windows
44
---
55

6-
# :material-microsoft-windows: How do I update AtlasOS to the latest version?
6+
# :material-microsoft-windows: Keeping AtlasOS Up-to-Date
77

8-
**Please refer to the compatibility table listed below.**
8+
Keeping your AtlasOS installation current ensures you benefit from the latest features, security updates, and compatibility improvements. How you update depends on the version you're currently running. You can find out which version you have by following the steps in the [Checking Your AtlasOS Version guide](./checking-atlas-version.md).
9+
10+
Check the table below to see the update options available for your version:
911

1012
| | Windows Update | Updating Atlas | Support from the Atlas team |
1113
| -------------- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | ----------------------------------- |
@@ -14,11 +16,15 @@ icon: material/microsoft-windows
1416
| v0.4.0 | :material-check-all: Will be able to update to 24H2 when v0.5 releases | :material-check: Will be able to update to Atlas v0.5 on its release | :material-check-all: Supported |
1517
| v0.4.1 | :material-check-all: Will be able to update to future Windows feature releases when v0.5 releases | :material-check: Will be able to update to Atlas v0.5 on its release | :material-check-all: Supported |
1618

17-
The latest versions of Atlas support cumulative Windows Updates, which include security and quality patches for Windows.
19+
**Good news!** If you're on version 0.4.0 or later, Atlas supports cumulative Windows Updates. This means you'll receive regular security and quality patches directly from Microsoft. When future major Windows versions (like 24H2) and new Atlas releases (like v0.5) become available, you'll be able to update smoothly.
20+
21+
## What if I'm on an older, unsupported version (v0.3.x or earlier)?
22+
23+
We understand it can be frustrating to be on an older version. Unfortunately, versions v0.3.x and earlier don't support direct updates to newer Atlas releases or the latest Windows feature updates.
1824

19-
## What should I do if I'm on an unsupported version?
25+
To ensure you have the best and most secure experience, we **strongly** recommend one of these options:
2026

21-
We **strongly** recommend that you do one of the following:
27+
1. **Fresh Start with the Latest Atlas:** [Reinstall Windows and then install the newest version of AtlasOS.](../getting-started/installation.md) This is the best way to get all the current benefits.
28+
2. **Return to Standard Windows:** [Reinstall a standard, unmodified version of Windows.](../getting-started/reverting-atlas.md)
2229

23-
- [Reinstall Windows and install the latest Atlas -->](../getting-started/installation.md)
24-
- [Reinstall to unmodified Windows -->](../getting-started/reverting-atlas.md)
30+
We know reinstalling can be a bit of work, but it's the safest path forward from these older versions.

‎docs/general-faq/upgrading-windows-version.md‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
description: Can I upgrade my Windows version (e.g., 10 to 11) with AtlasOS installed?
3+
icon: material/arrow-up-bold-box-outline
4+
---
5+
6+
# :material-arrow-up-bold-box-outline: Upgrading Windows Version with AtlasOS Installed
7+
8+
Upgrading your underlying Windows version (e.g., from Windows 10 to Windows 11) while AtlasOS is applied is **strongly discouraged and not supported.**
9+
10+
## :material-alert-circle-outline: Why is upgrading not supported?
11+
12+
AtlasOS applies deep modifications to the Windows operating system it's installed on. These changes are specific to the version and build of Windows present during the Atlas playbook execution.
13+
14+
Major Windows version upgrades (like the jump from 10 to 11) involve substantial changes to core system files, services, and the registry. Attempting to perform such an upgrade on an Atlas-modified system can lead to:
15+
16+
* **System Instability:** Conflicts between the upgrade process and Atlas modifications can cause crashes, boot loops, or unpredictable behavior.
17+
* **Broken Features:** Atlas tweaks or Windows features might stop working correctly.
18+
* **Partial or Full Reversion:** The upgrade process may overwrite or undo many of the optimizations and changes applied by Atlas.
19+
* **Unusable System:** In worst-case scenarios, the system may become unbootable or require a complete reinstallation.
20+
21+
Because of these potential conflicts and the unpredictability of the outcome, the Atlas team does not provide support for systems that have been upgraded in this manner.
22+
23+
## :material-tools: What is the recommended procedure?
24+
25+
If you wish to move to a newer version of Windows (e.g., Windows 11) and continue using AtlasOS, the **only recommended and supported method** is to perform a clean installation.
26+
27+
**Follow the official Installation Guide** to reinstall the desired Windows version (e.g., Windows 11) and apply the corresponding AtlasOS playbook. Remember to back up your personal data beforehand.
28+
29+
[:link: Atlas Installation Guide](../getting-started/installation.md)
30+
31+
This process ensures a clean slate for both the new Windows installation and the Atlas modifications, minimizing the risk of conflicts and ensuring a stable, supported system.

0 commit comments

Comments
 (0)