Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat(troubleshooting): defender error page, ame errors section, corrections #212

Merged
merged 2 commits into from
Jun 21, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/assets/images/ame-defender-inaccessible.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
@@ -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.
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down
Original file line number Diff line number Diff line change
@@ -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.**

Expand Down
Original file line number Diff line number Diff line change
@@ -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)

This file was deleted.

4 changes: 2 additions & 2 deletions docs/getting-started/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -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**
Expand All @@ -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
Expand Down
3 changes: 3 additions & 0 deletions mkdocs.insiders.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
8 changes: 5 additions & 3 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading