diff --git a/docs/assets/images/ame-defender-inaccessible.png b/docs/assets/images/ame-defender-inaccessible.png new file mode 100644 index 00000000..bed0690d Binary files /dev/null and b/docs/assets/images/ame-defender-inaccessible.png differ diff --git a/docs/faq-and-troubleshooting/ame-wizard-errors/ame-wizard-deleted.md b/docs/faq-and-troubleshooting/ame-wizard-errors/ame-wizard-deleted.md new file mode 100644 index 00000000..1eb6d1d9 --- /dev/null +++ b/docs/faq-and-troubleshooting/ame-wizard-errors/ame-wizard-deleted.md @@ -0,0 +1,32 @@ +--- +description: Why is AME Wizard being detected as a virus? +icon: material/virus +--- + +# :material-virus: Why is AME Wizard being detected as a virus? + +**AME Wizard can be falsely flagged as a virus. To avoid it being detected, add it to your Windows Defender exclusions list.** + +Windows Defender may automatically flag AME Wizard as malicious when trying to run it or even delete it before running it. + +To avoid these problems, temporarily disable **Real Time Protection** or follow [AME's Security Exceptions Documentation (recommended)](https://docs.ameliorated.io/guides/security-exceptions.html). + +## :material-file-question: Why is it being falsely flagged? + +### New releases + +Combined with the other factors below, new releases of AME Wizard are highly likely to be falsely flagged due to them never being seen before by Windows Defender. The more times that antiviruses see users use a program, the more the trust level goes up by antiviruses. + +### Lack of code signing + +Code signing is a system that allows users to verify that a third party has not altered the executable they receive. This is standard on most applications from companies, such as your web browser and games. Code signing makes false positives highly unlikely from antiviruses. + +However, code-signing certificates are expensive and tedious to get. This is why AME Wizard currently has no code signing certificate but will do so in the future. + +### Modifications to the operating system + +Some actions that AME Wizard can run are suspicious to antiviruses. + +For example, AME Wizard can irreversibly remove Windows Defender from Windows, which Atlas does not utilize, but some Playbooks do. In their Playbook's case, this is for the more extreme privacy their advanced users want. + +Although these removals are within the user's knowledge, antiviruses can see this and falsely flag AME Wizard as malicious. \ No newline at end of file diff --git a/docs/faq-and-troubleshooting/common-questions/atlas-playbook-stuck.md b/docs/faq-and-troubleshooting/ame-wizard-errors/atlas-playbook-stuck.md similarity index 97% rename from docs/faq-and-troubleshooting/common-questions/atlas-playbook-stuck.md rename to docs/faq-and-troubleshooting/ame-wizard-errors/atlas-playbook-stuck.md index 60f897ba..6524b56c 100644 --- a/docs/faq-and-troubleshooting/common-questions/atlas-playbook-stuck.md +++ b/docs/faq-and-troubleshooting/ame-wizard-errors/atlas-playbook-stuck.md @@ -10,7 +10,7 @@ When running the Playbook, some users might experience these messages: - **'Reticulating splines'** - meaning there has been no status change in 5 minutes - **'Action taking a long time'** - meaning there has been no status change in 15 minutes -Most of the time, this isn't an issue and is likely due to a slow internet connection or computer. However, it could be stuck if it has been on this screen for a long time. In that case, [scroll down to see solutions](#ensure-youre-on-a-clean-install-of-windows). +Most of the time, this isn't an issue and is likely due to a slow internet connection or computer. However, it could be stuck if it has been on this screen for a long time. In that case, [scroll down to see solutions](#prerequisites). ![AME Wizard 'Apply Playbook' window demonstrating what 'Reticulating Splines' and 'Action taking a long time' looks like](../../assets/images/reticulating-splines.webp) diff --git a/docs/faq-and-troubleshooting/common-questions/build-not-supported.md b/docs/faq-and-troubleshooting/ame-wizard-errors/build-not-supported.md similarity index 84% rename from docs/faq-and-troubleshooting/common-questions/build-not-supported.md rename to docs/faq-and-troubleshooting/ame-wizard-errors/build-not-supported.md index 163f2026..43f7bb89 100644 --- a/docs/faq-and-troubleshooting/common-questions/build-not-supported.md +++ b/docs/faq-and-troubleshooting/ame-wizard-errors/build-not-supported.md @@ -1,9 +1,9 @@ --- -description: What to do if your Windows build is not supported by AtlasOS. +description: How do I fix AME Wizard saying that this Windows build is not supported? icon: material/microsoft-windows-classic --- -# :material-microsoft-windows-classic: How do I fix AME Wizard saying that this Windows build not supported? +# :material-microsoft-windows-classic: How do I fix AME Wizard saying that this Windows build is not supported? **You have likely not followed the installation documentation to reinstall Windows.** diff --git a/docs/faq-and-troubleshooting/ame-wizard-errors/cant-disable-defender.md b/docs/faq-and-troubleshooting/ame-wizard-errors/cant-disable-defender.md new file mode 100644 index 00000000..1b4379af --- /dev/null +++ b/docs/faq-and-troubleshooting/ame-wizard-errors/cant-disable-defender.md @@ -0,0 +1,14 @@ +--- +description: How do I fix being unable to disable Defender to continue? +icon: material/shield-search +--- + +# :material-shield-search: How do I fix being unable to disable Defender to continue? + +**You have likely not followed the installation documentation to reinstall Windows.** + +Atlas requires you to follow the installation documentation to reinstall the latest version of Windows. We advise against using the **Reset this PC** feature within Windows, as this is not considered a complete Windows reinstall and would likely not solve this issue. + +[Installing AtlasOS -->](../../getting-started/installation.md) + +![AME Wizard erroring saying it can't open Windows Defender settings](../../assets/images/ame-defender-inaccessible.png) diff --git a/docs/faq-and-troubleshooting/common-questions/ame-wizard-deleted.md b/docs/faq-and-troubleshooting/common-questions/ame-wizard-deleted.md deleted file mode 100644 index ba41b2a9..00000000 --- a/docs/faq-and-troubleshooting/common-questions/ame-wizard-deleted.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -description: Why is AME Wizard being detected as a virus? -icon: material/virus ---- - -# :material-virus: Why is AME Wizard being detected as a virus? - -**AME Wizard can be falsely flagged as a virus. To avoid it being detected, add it to your Windows Defender exclusions list.** - -Windows Defender may automatically flag AME Wizard as malicious when trying to run it, or may even delete it before running it. - -To avoid these problems you can temporarily disable **Real Time Protection** or follow [AME's Security Exceptions Documentation (recommended)](https://docs.ameliorated.io/guides/security-exceptions.html). - -## :material-file-question: Why is it being falsely flagged? - -### New releases - -Combined with the other factors below, new releases of AME Wizard are highly likely to be falsely flagged due to them never being seen before by Windows Defender. The more times that antiviruses see users use a program, the more the trust level goes up by antiviruses. - -### Lack of code signing - -Code signing is a system that allows users to verify that the executable they receive has not been altered by a third party. This is standard on most applications from companies, such as your web browser and games. Code signing makes false positives highly unlikely from antiviruses. - -AME Wizard currently does not have a code signing certificate, however it is being worked on internally. - -### Modifications to the operating system - -Some actions that AME Wizard can run are suspicious to antiviruses. AME Wizard can remove Windows Defender only with the user's knowledge and if instructed by the Playbook, which antiviruses pick up on. \ No newline at end of file diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md index a6d339ad..63c52733 100644 --- a/docs/getting-started/installation.md +++ b/docs/getting-started/installation.md @@ -255,7 +255,7 @@ If you don't know, choose 'Driver Installation & Updates from Windows Update.' ??? danger "AME Wizard suddenly closing or being deleted?" Add AME Wizard as an exclusion or disable **Real-time protection** in the Windows Security settings. This is usually necessary when a new version of AME Wizard is released, which has not been used much yet. - To read more about this, view our [**AME Wizard Deleted**](../faq-and-troubleshooting/common-questions/ame-wizard-deleted.md) page. + To read more about this, view our [**AME Wizard Deleted**](../faq-and-troubleshooting/ame-wizard-errors/ame-wizard-deleted.md) page. 1. Open Microsoft Edge, search [`atlasos.net`](https://atlasos.net), then download the **Atlas Playbook** and **AME Wizard** @@ -272,7 +272,7 @@ If you don't know, choose 'Driver Installation & Updates from Windows Update.' 1. Restart after all updates are complete. After restarting, check again for updates repeatedly until there are no more updates that pop up 1. Open `AME Wizard Beta.exe` from the AME Wizard folder - 1. If there is a warning from SmartScreen that AME Wizard is an [unrecognized application](../faq-and-troubleshooting/common-questions/ame-wizard-deleted.md#why-is-it-being-falsely-flagged), bypass this warning by clicking **More info** and **Run anyway** + 1. If there is a warning from SmartScreen that AME Wizard is an [unrecognized application](../faq-and-troubleshooting/ame-wizard-errors/ame-wizard-deleted.md#why-is-it-being-falsely-flagged), bypass this warning by clicking **More info** and **Run anyway** 1. Click on **Updates** at the top and make sure AME Wizard is up to date 1. Drag `Atlas Playbook.apbx` from the Atlas Playbook folder into AME Wizard diff --git a/mkdocs.insiders.yml b/mkdocs.insiders.yml index 34fae16b..56ed6961 100644 --- a/mkdocs.insiders.yml +++ b/mkdocs.insiders.yml @@ -39,6 +39,9 @@ plugins: redirect_maps: 'getting-started/post-installation/atlas-folder/configuration.md': 'getting-started/post-installation/atlas-folder/general-configuration.md' 'getting-started/post-installation/atlas-folder/optional-tweaks.md': 'getting-started/post-installation/atlas-folder/interface-tweaks.md' + 'faq-and-troubleshooting/common-questions/atlas-playbook.stuck.md': 'faq-and-troubleshooting/ame-wizard-errors/atlas-playbook.stuck.md' + 'faq-and-troubleshooting/common-questions/build-not-supported.md': 'faq-and-troubleshooting/ame-wizard-errors/build-not-supported.md' + 'faq-and-troubleshooting/common-questions/ame-wizard-deleted.md': 'faq-and-troubleshooting/ame-wizard-errors/ame-wizard-deleted.md' # https://squidfunk.github.io/mkdocs-material/reference/#built-in-typeset-plugin (Insiders) - typeset diff --git a/mkdocs.yml b/mkdocs.yml index ddafe615..34764211 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -54,16 +54,18 @@ nav: - FAQ & Troubleshooting: - What's removed?: faq-and-troubleshooting/removed-features.md - Who is Atlas for?: faq-and-troubleshooting/who-is-atlas-for.md + - 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 + - Build Not Supported: faq-and-troubleshooting/ame-wizard-errors/build-not-supported.md + - Can't Disable Defender: faq-and-troubleshooting/ame-wizard-errors/cant-disable-defender.md - Common Questions: - Acrobat not installing: faq-and-troubleshooting/common-questions/acrobat-not-installing.md - - AME Wizard Deleted: faq-and-troubleshooting/common-questions/ame-wizard-deleted.md - Atlas and Security: faq-and-troubleshooting/common-questions/atlas-and-security.md - Atlas Folder Missing: faq-and-troubleshooting/common-questions/atlas-folder-missing.md - Atlas Folder Scripts: faq-and-troubleshooting/common-questions/atlas-folder-scripts.md - Atlas ISO files: faq-and-troubleshooting/common-questions/atlas-iso-files.md - - Atlas Playbook Stuck: faq-and-troubleshooting/common-questions/atlas-playbook-stuck.md - Bluetooth Compatibility: faq-and-troubleshooting/common-questions/bluetooth-compatibility.md - - Build Not Supported: faq-and-troubleshooting/common-questions/build-not-supported.md - Decrypting using BitLocker: faq-and-troubleshooting/common-questions/decryptying-using-bitlocker.md - iTunes Compatibility: faq-and-troubleshooting/common-questions/itunes-compatibility.md - Microsoft Store: faq-and-troubleshooting/common-questions/microsoft-store.md