diff --git a/docs/assets/images/windows-settings-atlas-version.png b/docs/assets/images/windows-settings-atlas-version.png new file mode 100644 index 00000000..d0ccf5f7 Binary files /dev/null and b/docs/assets/images/windows-settings-atlas-version.png differ diff --git a/docs/assets/images/winver-atlas-version.png b/docs/assets/images/winver-atlas-version.png new file mode 100644 index 00000000..e97ea01e Binary files /dev/null and b/docs/assets/images/winver-atlas-version.png differ diff --git a/docs/general-faq/atlas-and-security.md b/docs/general-faq/atlas-and-security.md index 3ff5a239..b1a7abb2 100644 --- a/docs/general-faq/atlas-and-security.md +++ b/docs/general-faq/atlas-and-security.md @@ -3,7 +3,7 @@ description: How secure is AtlasOS? icon: material/shield --- -# :material-shield: How secure is Atlas? +# :material-shield: How secure is AtlasOS? **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.** diff --git a/docs/general-faq/checking-atlas-version.md b/docs/general-faq/checking-atlas-version.md new file mode 100644 index 00000000..be5087e1 --- /dev/null +++ b/docs/general-faq/checking-atlas-version.md @@ -0,0 +1,40 @@ +--- +description: How to check which version of AtlasOS you have installed. +icon: material/information-outline +--- + +# :material-information-outline: Checking Your AtlasOS Version + +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. + +There are two primary ways to check your installed Windows version, which corresponds to your AtlasOS version: + +## 1. Using the `winver` Command + +This is a quick way to see your Windows build number and the Atlas Playbook version. + +1. Press ++win+r++ on your keyboard to open the Run dialog. +2. Type `winver` and press Enter or click OK. +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`). + +
+ ![Winver dialog showing Atlas Playbook version](../assets/images/winver-atlas-version.png) +
Atlas Playbook v0.4.1 shown in the winver dialog
+
+ +## 2. Using Windows Settings + +You can also find detailed system information, including the Atlas Playbook version, in the Settings app. + +1. Open Windows Settings (you can press ++win+i++). +2. Navigate to `System`. +3. Click on `About`. +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`). +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). + +
+ ![Windows Settings About page showing Atlas Playbook version under the device name](../assets/images/windows-settings-atlas-version.png) +
Atlas Playbook v0.4.1 shown in the Windows Settings About page
+
+ +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. \ No newline at end of file diff --git a/docs/general-faq/enabling-tpm.md b/docs/general-faq/enabling-tpm.md new file mode 100644 index 00000000..f3e7b57d --- /dev/null +++ b/docs/general-faq/enabling-tpm.md @@ -0,0 +1,67 @@ +--- +title: Enabling TPM 2.0 for Windows 11 Installation +description: How to enable the Trusted Platform Module (TPM) in your system's BIOS/UEFI, a requirement for Windows 11. +icon: material/chip +--- + +# :material-chip: Enabling TPM 2.0 for Windows 11 Installation + +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. + +TPM is a security feature built into modern motherboards or CPUs that provides hardware-based security functions. + +!!! warning "Proceed with Caution" + 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. + +## Step 1: Accessing BIOS/UEFI + +You need to restart your computer and enter the BIOS/UEFI setup utility before Windows starts loading. + +1. **Restart your computer.** +2. **Immediately press the BIOS/UEFI entry key repeatedly** as the system powers on. Common keys include: + * `DEL` (Delete) + * `F2` + * `F10` + * `F12` + * `ESC` (Escape) + * 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. + +## Step 2: Finding the TPM Setting + +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. + +* **Look for sections named:** + * `Security` + * `Advanced` + * `Trusted Computing` + * `Peripherals` + * `CPU Configuration` + +* **Look for setting names like:** + * `TPM` / `TPM Device` / `TPM Support` / `TPM State` + * `Security Device` / `Security Device Support` + * **For Intel CPUs:** `PTT` (Platform Trust Technology) or `Intel PTT` + * **For AMD CPUs:** `fTPM` (Firmware TPM) or `AMD fTPM switch` / `CPU fTPM` + +!!! tip "Can't find it?" + 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. + +## Step 3: Enabling TPM + +Once you find the setting: + +1. Select the TPM (or equivalent, like PTT/fTPM) option. +2. Change its value from `Disabled` / `Off` / `Hidden` to `Enabled` / `On` / `Available` / `Firmware TPM`. + * *Note:* Sometimes there are separate options for the TPM state and device visibility. Ensure the device itself is enabled or activated. + +## Step 4: Saving Changes and Exiting + +1. Navigate to the `Exit` section of your BIOS/UEFI. +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`. +3. Your computer will restart. + +## Step 5: Retry Windows Installation + +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. + +If you continue to have problems, double-check your BIOS/UEFI settings and consult your hardware manufacturer's documentation. \ No newline at end of file diff --git a/docs/general-faq/installation-data-loss.md b/docs/general-faq/installation-data-loss.md new file mode 100644 index 00000000..ac8849aa --- /dev/null +++ b/docs/general-faq/installation-data-loss.md @@ -0,0 +1,36 @@ +--- +description: Do I need to reinstall Windows or lose my data to install AtlasOS? +icon: material/database-arrow-down-outline +--- + +# :material-database-arrow-down-outline: Installing AtlasOS, Fresh Install & Data Loss + +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: + +## :material-help-circle-outline: Do I need to reinstall Windows? + +**Yes, a fresh/clean installation of Windows is required for a stable and functional AtlasOS experience.** + +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. + +For a working and supported AtlasOS system, you **must**: +1. Perform a clean installation of a compatible Windows version. +2. Apply the Atlas playbook immediately after the Windows setup. + +[:link: Refer to the Installation Guide for supported Windows versions and steps](../getting-started/installation.md) + +## :material-file-document-outline: Will I lose my personal files and data? + +**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. + +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. + +## :material-microsoft-windows: Do I need Windows installed first? + +**Yes.** AtlasOS is a modification applied on top of Windows; it is **not** a standalone operating system. + +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. + +**Do not proceed further without consulting the guide:** + +[:link: Atlas Installation Guide](../getting-started/installation.md) \ No newline at end of file diff --git a/docs/general-faq/microsoft-account-usage.md b/docs/general-faq/microsoft-account-usage.md new file mode 100644 index 00000000..e83caaac --- /dev/null +++ b/docs/general-faq/microsoft-account-usage.md @@ -0,0 +1,29 @@ +--- +description: Can I use my Microsoft account with AtlasOS or the Microsoft Store? +icon: material/account-circle-outline +--- + +# :material-account-circle-outline: Using Your Microsoft Account with AtlasOS + +A common question is whether you can or should use your Microsoft account with AtlasOS. Here's the breakdown: + +## :material-store: Microsoft Store and Apps + +**Yes, you can sign in with your Microsoft account within the Microsoft Store** or within specific applications (like the Xbox app) that require it. + +This allows you to: + +* Install apps you own. +* Access subscriptions linked to your account (like Game Pass). +* Sync progress in certain games or apps. + +Signing into the Store or individual apps does **not** require you to use a Microsoft account for your main Windows login. + +## :material-account-off-outline: Windows User Account (Login) + +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.** + +* **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. +* **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. + +**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. \ No newline at end of file diff --git a/docs/general-faq/resetting-atlas.md b/docs/general-faq/resetting-atlas.md new file mode 100644 index 00000000..7bdf1ffe --- /dev/null +++ b/docs/general-faq/resetting-atlas.md @@ -0,0 +1,32 @@ +--- +description: Explains why the standard Windows 'Reset this PC' feature doesn't work with AtlasOS and details the correct procedure. +icon: material/backup-restore +--- + +# :material-backup-restore: Resetting or Reinstalling AtlasOS + +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.** + +## :material-alert-circle-outline: Why Standard Windows Reset Fails + +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. + +Attempting to use "Reset this PC" will likely fail or leave your system in a broken, inconsistent, and unsupported state. + +**Do NOT use the standard Windows "Reset this PC" option.** + +## :material-tools: The Correct Way to "Reset" or Reinstall AtlasOS + +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. + +**Before you begin, make sure to back up any important personal data**, as this process involves reinstalling Windows and will wipe your system drive. + +**Follow the official Installation Guide for detailed steps:** + +[:link: Atlas Installation Guide](../getting-started/installation.md) + +## :material-undo-variant: Just Want to Remove Atlas? + +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. + +[:link: Reverting Atlas Guide](../getting-started/reverting-atlas.md) \ No newline at end of file diff --git a/docs/general-faq/updating-atlas.md b/docs/general-faq/updating-atlas.md index e164f77b..73b8d4b3 100644 --- a/docs/general-faq/updating-atlas.md +++ b/docs/general-faq/updating-atlas.md @@ -3,9 +3,11 @@ description: How do I update AtlasOS to the latest version? icon: material/microsoft-windows --- -# :material-microsoft-windows: How do I update AtlasOS to the latest version? +# :material-microsoft-windows: Keeping AtlasOS Up-to-Date -**Please refer to the compatibility table listed below.** +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). + +Check the table below to see the update options available for your version: | | Windows Update | Updating Atlas | Support from the Atlas team | | -------------- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | ----------------------------------- | @@ -14,11 +16,15 @@ icon: material/microsoft-windows | 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 | | 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 | -The latest versions of Atlas support cumulative Windows Updates, which include security and quality patches for Windows. +**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. + +## What if I'm on an older, unsupported version (v0.3.x or earlier)? + +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. -## What should I do if I'm on an unsupported version? +To ensure you have the best and most secure experience, we **strongly** recommend one of these options: -We **strongly** recommend that you do one of the following: +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. +2. **Return to Standard Windows:** [Reinstall a standard, unmodified version of Windows.](../getting-started/reverting-atlas.md) -- [Reinstall Windows and install the latest Atlas -->](../getting-started/installation.md) -- [Reinstall to unmodified Windows -->](../getting-started/reverting-atlas.md) +We know reinstalling can be a bit of work, but it's the safest path forward from these older versions. diff --git a/docs/general-faq/upgrading-windows-version.md b/docs/general-faq/upgrading-windows-version.md new file mode 100644 index 00000000..48a50273 --- /dev/null +++ b/docs/general-faq/upgrading-windows-version.md @@ -0,0 +1,31 @@ +--- +description: Can I upgrade my Windows version (e.g., 10 to 11) with AtlasOS installed? +icon: material/arrow-up-bold-box-outline +--- + +# :material-arrow-up-bold-box-outline: Upgrading Windows Version with AtlasOS Installed + +Upgrading your underlying Windows version (e.g., from Windows 10 to Windows 11) while AtlasOS is applied is **strongly discouraged and not supported.** + +## :material-alert-circle-outline: Why is upgrading not supported? + +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. + +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: + +* **System Instability:** Conflicts between the upgrade process and Atlas modifications can cause crashes, boot loops, or unpredictable behavior. +* **Broken Features:** Atlas tweaks or Windows features might stop working correctly. +* **Partial or Full Reversion:** The upgrade process may overwrite or undo many of the optimizations and changes applied by Atlas. +* **Unusable System:** In worst-case scenarios, the system may become unbootable or require a complete reinstallation. + +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. + +## :material-tools: What is the recommended procedure? + +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. + +**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. + +[:link: Atlas Installation Guide](../getting-started/installation.md) + +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. \ No newline at end of file diff --git a/docs/general-faq/windows-10-vs-11.md b/docs/general-faq/windows-10-vs-11.md new file mode 100644 index 00000000..b521553d --- /dev/null +++ b/docs/general-faq/windows-10-vs-11.md @@ -0,0 +1,35 @@ +--- +description: Should I use Windows 10 or Windows 11 with AtlasOS? +icon: material/microsoft-windows +--- + +# :material-alert-decagram-outline: Windows 11 is Strongly Recommended for AtlasOS + +When choosing which Windows version to use as a base for AtlasOS, **Windows 11 is the strongly recommended and preferred choice.** While Windows 10 is currently supported, its use is discouraged due to its upcoming end of support. + +## :material-calendar-remove: Windows 10 End of Support (October 14, 2025) + +Microsoft's official support for Windows 10 is scheduled to end on **October 14, 2025**. After this date, Windows 10 will no longer receive critical security updates, non-security fixes, or technical support from Microsoft. + +Running an operating system without security updates poses a significant security risk. + +## :material-dev-to: Atlas Development Focus & Future Support + +AtlasOS development prioritizes compatibility and optimization for the **latest supported Windows versions**, which is currently Windows 11. + +* **Primary Focus:** Windows 11 receives the primary focus for development, testing, and new features. +* **Secondary Support for Windows 10:** While Windows 10 is supported for now, it is considered secondary. +* **End of Atlas Support for Win10:** AtlasOS will **cease support for Windows 10** in alignment with Microsoft's end-of-life date (October 14, 2025). Future Atlas releases beyond this date may not be compatible with or tested on Windows 10. + +## :material-check-decagram-outline: Conclusion: Use Windows 11 + +Using Windows 11 as the base for your AtlasOS installation is crucial for: + +* Receiving ongoing security updates from Microsoft. +* Ensuring the best compatibility and performance with current and future AtlasOS releases. +* Maintaining a secure and stable system. + +We strongly advise against new installations using Windows 10. + +[:link: View Supported Windows Versions](/install-faq/windows-version-support) +[:link: Atlas Installation Guide](/getting-started/installation) \ No newline at end of file diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md index 5ae307c3..c6a79a83 100644 --- a/docs/getting-started/installation.md +++ b/docs/getting-started/installation.md @@ -131,6 +131,10 @@ Before continuing, we **strongly** recommend you back up any valuable data to an - [Windows Pro](../install-faq/windows-version-support.md#which-windows-editions-are-supported) is recommended. [Windows Home is not officially supported](../install-faq/windows-home.md) - If the Windows Setup did not give a choice of edition and it installs Windows Home anyway, you can always change Windows edition later by changing your Windows product key once Windows has finished reinstalling, without having to reinstall anything + + !!! note "Windows 11 Requirement Error?" + If installing Windows 11 and you encounter an error stating your PC doesn't meet the requirements, you might need to enable TPM 2.0 in your BIOS/UEFI. See our guide: [:link: Enabling TPM 2.0](../general-faq/enabling-tpm.md) + 1. Accept the license agreement and click **Custom: Install Windows only (advanced)** @@ -199,6 +203,10 @@ Before continuing, we **strongly** recommend you back up any valuable data to an 1. Choose your Windows edition --8<-- "installation.md:atlasEditions" + + !!! note "Windows 11 Requirement Error?" + If installing Windows 11 and you encounter an error stating your PC doesn't meet the requirements, you might need to enable TPM 2.0 in your BIOS/UEFI. See our guide: [:link: Enabling TPM 2.0](../general-faq/enabling-tpm.md) + 1. Accept the license agreement and click **Custom: Install Windows only (advanced)** @@ -208,9 +216,8 @@ Before continuing, we **strongly** recommend you back up any valuable data to an === "Keeping data (recommended)" !!! note "Previous Windows data" - --8<-- "installation.md:windowsOldNotice" - - + + - Identify the disk partition you want to install Windows to by looking at the total sizes, then select it - Click **Next**, then click **OK** to the warning about `Windows.old` diff --git a/mkdocs.yml b/mkdocs.yml index ecf180fb..7ad21a43 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -66,6 +66,7 @@ nav: - Windows Home Support: install-faq/windows-home.md - Atlas ISO files: install-faq/atlas-iso-files.md - Decrypting using BitLocker: install-faq/decrypting-using-bitlocker.md + - Enabling TPM 2.0: general-faq/enabling-tpm.md - Reverting Atlas: getting-started/reverting-atlas.md # discord_friendly_name: ['revert', 'uninstall-atlas'] - AME Wizard Errors: @@ -75,19 +76,29 @@ nav: - Can't Disable Defender: install-faq/ame-wizard-errors/cant-disable-defender.md - General FAQ: + # Top-level common FAQs - Atlas and Security: general-faq/atlas-and-security.md + - Checking Atlas Version: general-faq/checking-atlas-version.md - Updating Atlas: general-faq/updating-atlas.md - - Atlas Folder Missing: general-faq/atlas-folder-missing.md - - Windows Update Errors: general-faq/windows-update-errors.md - - Testing Nightly Builds: general-faq/testing-nightly-builds.md - - Bluetooth Compatibility: general-faq/bluetooth-compatibility.md - - iTunes Compatibility: general-faq/itunes-compatibility.md - - Installing the Media Pack: general-faq/media-pack-not-found.md - - Microsoft Store: general-faq/microsoft-store.md - - 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 + - Upgrading Windows Version: general-faq/upgrading-windows-version.md + - Windows 10 vs 11: general-faq/windows-10-vs-11.md + - Installation & Data Loss: general-faq/installation-data-loss.md + - Microsoft Account Usage: general-faq/microsoft-account-usage.md + # Sub-sections for other FAQs + - Troubleshooting: + - Resetting Atlas: general-faq/resetting-atlas.md + - Atlas Folder Missing: general-faq/atlas-folder-missing.md + - Windows Update Errors: general-faq/windows-update-errors.md + - Bluetooth Compatibility: general-faq/bluetooth-compatibility.md + - iTunes Compatibility: general-faq/itunes-compatibility.md + - Installing the Media Pack: general-faq/media-pack-not-found.md + - Microsoft Store: general-faq/microsoft-store.md + - 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 + - Advanced Topics: + - Verify ISO integrity: general-faq/verify-iso-integrity.md + - Testing Nightly Builds: general-faq/testing-nightly-builds.md - Development: - Contribution Guidelines: contributing/contribution-guidelines.md