diff --git a/docs/faq-and-troubleshooting/common-questions/reverting-atlas.md b/docs/faq-and-troubleshooting/common-questions/reverting-atlas.md deleted file mode 100644 index 7b12af25..00000000 --- a/docs/faq-and-troubleshooting/common-questions/reverting-atlas.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -description: How do I return to Windows after installing AtlasOS? -icon: material/microsoft-windows ---- - -# :material-microsoft-windows: How do I revert AtlasOS' changes? - -**You'll need to reinstall Windows to revert Atlas' modifications.** - -Due to the number of modifications Atlas makes, there is currently no single-click way to revert its changes. Options built into Windows, such as those from Windows Recovery or Advanced Startup, are not recommended because they will not revert all modifications. - -To reinstall Windows, follow [Microsoft's guide using installation media](https://support.microsoft.com/windows/reinstall-windows-d8369486-3e33-7d9c-dccc-859e2b022fc7) or another guide using an ISO file/installation media. \ No newline at end of file diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md index 63c52733..7d3e539a 100644 --- a/docs/getting-started/installation.md +++ b/docs/getting-started/installation.md @@ -10,17 +10,22 @@ This guide will walk you through fully reinstalling Windows, installing Atlas on Before continuing, we recommend reviewing our page on [who Atlas is for](../faq-and-troubleshooting/who-is-atlas-for.md). + ## :material-clipboard-list-outline: Prerequisites - Meeting the system requirements for [Windows 11](https://www.microsoft.com/windows/windows-11-specifications#table1) or [Windows 10](https://www.microsoft.com/windows/windows-10-specifications#primaryR2) - We don't recommend bypassing Windows 11's requirements due to potential incompatibilities with updates and anticheats - 64-bit CPU ([you can check what you have](https://support.microsoft.com/en-us/windows/which-version-of-windows-operating-system-am-i-running-628bec99-476a-2c13-5296-9dd081cdd808)) + - If you have an ARM-based CPU, you can only use Atlas with Windows 11 - Knowledge of general Windows troubleshooting and usage + ## :material-disc: Download an ISO + -Before installing Atlas, you need to reinstall Windows. To fully reinstall Windows, you need to download your desired Windows version's ISO file, which will be used later in the guide. +Before installing Atlas, you need to reinstall Windows. +To fully reinstall Windows, you need to download your desired Windows version's ISO file, which will be used later in the guide. The buttons below download an ISO directly from Microsoft's servers. It gets the latest version of your desired Windows version for [Intel and AMD CPUs](https://www.tenforums.com/tutorials/132836-check-what-processor-cpu-windows-pc.html#option1). ARM ISOs have to be [built manually](https://uupdump.net/fetchupd.php?arch=arm64&ring=retail&build=22631.1). @@ -86,7 +91,9 @@ See the alternatives below. styleSheet.innerText = '.noJs { display: revert !important }' document.head.appendChild(styleSheet) + + ## :material-ethernet: Network Drivers By default, Windows may not have your computer's network drivers, meaning your computer would be left without a network connection. @@ -97,7 +104,9 @@ For this reason, we **strongly** recommend that you either: - Have the ability to download and transfer network drivers from another device later You can find your network driver online by searching for your device/motherboard's official support page or your network device's name in [Device Manager](../assets/images/device-manager-nic.webp) instead. If multiple of the latest network drivers are available on your device, download all of them. + + ## :material-microsoft-windows: Reinstalling Windows !!! question "Which method should I pick?" @@ -124,7 +133,10 @@ You can find your network driver online by searching for your device/motherboard 1. Click **I don't have a product key**, as Windows will activate automatically later, presuming that Windows is legitimately activated beforehand - 1. Choose your edition of Windows. We strongly recommend and officially support Windows Pro, with **Windows Home not being officially supported.** See our page on [Windows Editions](../faq-and-troubleshooting/common-questions/windows-editions.md) for more information + 1. Choose your edition of Windows + + - For Atlas, we strongly recommend and officially support Windows Pro, with **Windows Home not being officially supported.** See our page on [Windows Editions](../faq-and-troubleshooting/common-questions/windows-editions.md) for more information + 1. Accept the license agreement and click **Custom: Install Windows only (advanced)** @@ -185,6 +197,8 @@ You can find your network driver online by searching for your device/motherboard 1. At the Ventoy menu, select the Windows ISO using the arrow keys, press ++enter++, click **Boot in normal mode**, and press ++enter++ again 1. Follow [Microsoft's guide](https://support.microsoft.com/en-us/windows/reinstall-windows-d8369486-3e33-7d9c-dccc-859e2b022fc7#ID0EDBBBBBBBDBD) for a clean installation from step 4 (clicking **Install now**) + + - For Atlas, we strongly recommend and officially support Windows Pro, with **Windows Home not being officially supported.** See our page on [Windows Editions](../faq-and-troubleshooting/common-questions/windows-editions.md) for more information ### :material-cog: Initial setup (OOBE) @@ -279,13 +293,15 @@ If you don't know, choose 'Driver Installation & Updates from Windows Update.' 1. Follow the on-screen instructions from AME Wizard to successfully install AtlasOS + ### :material-microsoft-windows-classic: Your old Windows installation -If you reinstalled Windows using the method in the documentation, your previous Windows installation should be in `Windows.old`. When you're sure that you've retrieved any valuable data from it, follow these steps: +If you reinstalled Windows using the no-USB method, your previous Windows installation should be in `Windows.old`. When you're sure that you've retrieved any valuable data from it, follow these steps: 1. Open **Windows Settings** -> **System** -> **Storage** 1. Click **Temporary files**, and wait for it to scan your files 1. Select **Previous version of Windows**, and then click **Remove files** + ## :material-package-variant-closed-plus: Getting your drivers diff --git a/docs/getting-started/reverting-atlas.md b/docs/getting-started/reverting-atlas.md new file mode 100644 index 00000000..27a97fea --- /dev/null +++ b/docs/getting-started/reverting-atlas.md @@ -0,0 +1,49 @@ +--- +title: Reverting Atlas +description: How to uninstall AtlasOS +icon: material/emoticon-cry +--- + +# :material-emoticon-cry: Reverting Atlas + +As Atlas disables the 'Reset this PC' feature due to its unreliability and not being a true reinstall of Windows, some users get confused about how to get back to stock Windows. + +This page details how to reinstall from Atlas to stock Windows fully, which uninstalls Atlas. + +## :material-handshake: Before uninstalling + +If you're experiencing issues, ensure you're on the [latest version of Atlas](installation.md), and then consider getting help from the following: + +- :material-file-search: The documentation you're on currently +- + :material-robot: 'Ask AI' in the corner of this page + +- [:simple-discord: Our Discord server](https://discord.atlasos.net) +- [:material-forum: The Atlas forums](https://forum.atlasos.net) + +### If you're still having problems... + +We're constantly improving Atlas, so although you're uninstalling now, we hope to see your problem solved in the future. + +Please consider reporting your problem on the [Atlas GitHub Issues](https://github.com/Atlas-OS/Atlas/issues) so we can fix it. +Alternatively, give feedback in our forums or Discord, as mentioned earlier. + +--- + +!!! tip "Looking to reinstall/install Atlas?" + Follow the [Atlas installation guide](installation.md) instead. This page is for reverting Atlas. + +--8<-- +installation.md:prerequisites +installation.md:iso +installation.md:iso1 +installation.md:drivers +installation.md:reinstalling +installation.md:reinstalling1 +--8<-- + +## :material-desktop-classic: Continue with setup + +You should now be at the regular Windows initial setup and back on stock Windows. + +--8<-- "installation.md:oldinstall" \ No newline at end of file diff --git a/docs/javascript/init_kapa_widget.v1.js b/docs/javascript/init_kapa_widget.v2.js similarity index 91% rename from docs/javascript/init_kapa_widget.v1.js rename to docs/javascript/init_kapa_widget.v2.js index 874c472b..3cb2248f 100644 --- a/docs/javascript/init_kapa_widget.v1.js +++ b/docs/javascript/init_kapa_widget.v2.js @@ -23,4 +23,9 @@ document.addEventListener("DOMContentLoaded", function () { }; document.head.appendChild(script); -}); \ No newline at end of file +}); + +function clickKapaAi() { + const button = document.querySelector('#kapa-widget-container > button') + if (button) button.click() +} diff --git a/mkdocs.insiders.yml b/mkdocs.insiders.yml index e42276a2..571b5e00 100644 --- a/mkdocs.insiders.yml +++ b/mkdocs.insiders.yml @@ -49,5 +49,10 @@ plugins: # Moved as it gives mostly software recommendations 'faq-and-troubleshooting/common-questions/recommended-antiviruses.md': 'getting-started/post-installation/software/anti-virus.md' + # Moved to a more fully fleged page + # Has to be in 'getting-started' for relative links + 'faq-and-troubleshooting/common-questions/reverting-atlas.md': 'getting-started/reverting-atlas.md' + 'faq-and-troubleshooting/reverting-atlas.md': 'getting-started/reverting-atlas.md' + # https://squidfunk.github.io/mkdocs-material/reference/#built-in-typeset-plugin (Insiders) - typeset diff --git a/mkdocs.yml b/mkdocs.yml index 799a7e16..93eb7ffb 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -61,6 +61,8 @@ nav: - What's removed?: faq-and-troubleshooting/removed-features.md # discord_bot_names: ['removed-features', 'deleted-features', 'whats-stripped'] - Who is Atlas for?: faq-and-troubleshooting/who-is-atlas-for.md + - Reverting Atlas: getting-started/reverting-atlas.md + # discord_friendly_name: ['revert', 'uninstall-atlas'] - AME Wizard Errors: - AME Wizard Deleted: faq-and-troubleshooting/ame-wizard-errors/ame-wizard-deleted.md - Atlas Playbook Stuck: faq-and-troubleshooting/ame-wizard-errors/atlas-playbook-stuck.md @@ -81,7 +83,6 @@ nav: - iTunes Compatibility: faq-and-troubleshooting/common-questions/itunes-compatibility.md - Installing the Media Pack: faq-and-troubleshooting/common-questions/media-pack-not-found.md - Microsoft Store: faq-and-troubleshooting/common-questions/microsoft-store.md - - Reverting Atlas: faq-and-troubleshooting/common-questions/reverting-atlas.md - Roblox not opening: faq-and-troubleshooting/common-questions/roblox-not-opening.md - FIFA/EAFC not launching: faq-and-troubleshooting/common-questions/fifa-and-eafc-not-launching.md @@ -158,7 +159,7 @@ theme: # extra_javascript: - javascript/msdl.v1.js - - javascript/init_kapa_widget.v1.js + - javascript/init_kapa_widget.v2.js extra_css: @@ -250,6 +251,7 @@ markdown_extensions: - pymdownx.snippets: auto_append: - includes/abbreviations.md + base_path: ['./docs/getting-started/'] # https://squidfunk.github.io/mkdocs-material/reference/content-tabs - pymdownx.tabbed: