From d4587eb6d9406d7d38047e04008050905d82efd3 Mon Sep 17 00:00:00 2001 From: Creeper Date: Tue, 21 Oct 2025 13:03:52 -0400 Subject: [PATCH 1/5] feat: updated ISO injection page --- .../install/before-continuing.md | 2 +- .../install/install-iso-injection.md | 222 +++++++++++++++++- mkdocs.yml | 2 +- 3 files changed, 223 insertions(+), 3 deletions(-) diff --git a/docs/getting-started/install/before-continuing.md b/docs/getting-started/install/before-continuing.md index 4e0cc375..82349823 100644 --- a/docs/getting-started/install/before-continuing.md +++ b/docs/getting-started/install/before-continuing.md @@ -29,7 +29,7 @@ Atlas provides two installation methods, Playbook & ISO Injection. **[-> Install with Playbook](install-playbook.md)** -- #### :material-minidisc: ISO Injection +- #### :material-minidisc: ISO Injection (EXPERIMENTAL) --- diff --git a/docs/getting-started/install/install-iso-injection.md b/docs/getting-started/install/install-iso-injection.md index c90529e5..ecc04d44 100644 --- a/docs/getting-started/install/install-iso-injection.md +++ b/docs/getting-started/install/install-iso-injection.md @@ -2,9 +2,229 @@ description: Install AtlasOS using the ISO injection method for experienced users icon: material/disc-player --- + +## :material-disc: **1.** Download an ISO + -## TBD + +!!! danger "ISO Injection with non-english ISOs break the administrator account" + This is a known issue with AME Wizard. Please download your ISO using AME Wizard, or download an english ISO using our alternatives. +!!! danger "ISO Injection currently disables Ctrl+Alt+Del keybind" + This is a known issue with AME Wizard. Please do a [traditional playbook install](.\install-playbook.md) if you are not comfortable with this. + +Due to issues with ISOs, we recommend you use AME Wizard's ISO downloader +1. Open your web browser, search [`atlasos.net`](https://atlasos.net) + +1. On the website, click 'Get started', then click **-> Already following the guide?** at the bottom of the pop-up, and download the **Atlas Playbook** and **AME Wizard** +1. Extract both downloads to your desktop +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/ame.md#why-is-ame-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. Click on the **More Options** tab on the left side of the window +2. Select **Download ISO** and make sure **Windows 11** is selected, then click **Ok** +This should download a Windows 11 25H2 ISO. + + + + + +??? grey-tip "Alternatives" + + !!! tip + Even though the downloader in our docs uses official Microsoft servers, you can still download the ISO directly from their website. + + === "Classic ISO downloader (MSDL)" + Due to issues with non-english ISOs, we higly recommend you use AME Wizard's built in downloader. + + If you still wish to use the built-in ISO downloader, + please go to the [traditional playbook install](.\install-playbook.md) page and download an **english ISO** there, then come back here. + + === "Official Microsoft Sources" + + ### [Windows 11 :material-download:](https://www.microsoft.com/en-us/software-download/windows11) + + - Click the link above and find "Download Windows 11 Disk Image (ISO) for x64 devices" + - Click on the"Select Download" dropdown, choose **Windows 11 (multi-edition ISO)**, and click **Confirm.** + - Select your desired language and press confirm. + - Click **64-bit Download** to begin your download. + + + + +## :material-file-edit: Injecting the playbook +1. Drag `Atlas Playbook.apbx` from the Atlas Playbook folder folder into AME Wizard +2. Select the Windows 11 ISO previously downloaded +3. Click on the **Select a playbook to modify** +4. Make sure AtlasOS is selected, and click **Ok** +5. Click next when you see **AtlasOS Playbook selected** +6. Select all the options you would normally choose when installing AtlasOS playbook +7. At the end, you will be prompted to select which drivers you want to come with the ISO, we recommend keeping **Include additional network drivers** selected +8. Click **Next**. You will be asked to choose a username, then a password, and then click **Next** + 1. If you do not want a password, leave the box empty and click **Next** +9. Wait for the injection to finish + +## :material-microsoft-windows: **3.** Reinstalling Windows + +Before continuing, we **strongly** recommend you back up any valuable data to an external drive or [a cloud service](before-continuing.md). + +=== ":material-microsoft: No USB Drive (recommended)" + + + **Only if you have enough free storage**, after finishing the Windows reinstall, `Windows.old` will be at the start of your Windows drive, containing your old data. You can retrieve data from the folder and delete it afterward, which this guide [covers later](#your-old-windows-installation). + + + This method only works if you're already on Windows. + + 1. Disconnect any cables providing internet to your computer, such as an ethernet cable. Do not reconnect any until instructed to do so + + 1. Right-click the previously downloaded ISO file and select **Open With** -> **File Explorer** + + 1. Open **This PC** in File Explorer, and remember the ISO's drive letter (e.g. `H`) for the next step. The drive should look similar to ![Windows Setup icon](/assets/images/win-setup.webp){ .twemoji } **CCCOMA_X64FRE_EN-GB_DV9** + + 1. Press ++win+r++ to open the Run dialog + + 1. Inside the Run dialog, type in the previously remembered drive letter, and then **without a space**, type `:\sources\setup.exe` after it. [**Example:** `H:\sources\setup.exe`](/assets/images/win-setup-run-dialog.webp) + + 1. Press ++enter++ on the Run dialog, and accept the User Account Control prompt + - The message ["Make sure BitLocker Drive Encryption is suspended"](/assets/images/bitlocker-error-setup.jpg) could appear from the Windows Setup when you press ++enter++. Refer to our [BitLocker decrypting instructions](../../faq/install.md) to resolve this, then retry from step 5 onwards + + 1. Select **No thanks** when prompted for updates, then uncheck the box for **I want to help make the Windows installation better** + + 1. If prompted, click **I don't have a product key**, as Windows should auto-activate later + - If Windows doesn't auto-activate, you can enter a key later within Windows + + 1. Choose your edition of Windows. + + + + !!! note "Supported Editions" + + - Windows Pro + - Windows Pro for Workstation + - Windows Enterprise (Excluding LTSC, IoT LTSC) + + **Windows Home is not Supported.** 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. + + + + + 2. Accept the license agreement and click **Custom: Install Windows only (advanced)** + + 3. Select your Windows drive, click **Next**, click **OK** to the warning about `Windows.old`, and let the installation finish + +=== ":material-usb-flash-drive: USB Drive" + + This method works on Linux and Windows. + + !!! tip + Even thought this method works on both Linux and Windows, please note that AME Wizard and ISO Injection only works in Windows. + + 1. Download the latest release of [Ventoy :material-download:](https://github.com/ventoy/Ventoy/releases/) and extract it wherever you feel comfortable. + - Linux users can get it using a package manager + + 2. Inside the Ventoy folder, run **Ventoy2Disk** + + 3. In the opened window, select your USB drive and click **Install** + - This will destroy all data on the USB drive! + + 4. Copy your downloaded ISO file into the USB drive (labeled Ventoy) + + 5. Disconnect any cables providing your computer internet, such as an ethernet cable + - Do not reconnect to the internet until instructed to + + 6. Restart your computer, boot into your BIOS' boot menu, then select the USB drive + + ??? failure "'Security Violation' Error" + + ??? tip "Video Demonstration" +
+ +

Credit to [Ventoy](https://ventoy.net/doc_secure.html) for the video demonstration.

+

+ + ![vtoy-verification-error-0x1A](/assets/images/vtoy-secure-error.png){ align=right width=200 } + + If you get an error screen saying there was a 'Security Violation,' follow the steps below: + + 1\. Press ++enter++ to load **MokManager** + + 2\. Press any key to begin key management + + 3\. Choose **Enroll Key From Disk** + + - The controls are arrow keys to move and ++enter++ to select + + 4\. Choose `VTOYEFI` + + 5\. Choose `ENROLL_THIS_KEY_IN_MOKMANAGER.cer` + + 6\. Choose **Continue**, then **Yes**, and finally **Reboot** + + 7\. Boot from the USB again, as the issue should be resolved + + ------ + + If it is still not working, try 'Hash Enrollment,' as detailed in [Ventoy's guide](https://ventoy.net/doc_secure.html). + + 7. Once booted into the Ventoy menu, select the Windows ISO using the arrow keys, press ++enter++, click **Boot in normal mode**, and press ++enter++ again + + 8. **If you're installing Windows 11,** once booted into the Windows Setup, click 'Next' twice, then click 'Previous version of setup' in the bottom left corner of the window + + 9. Select your preferred language preferences, click **Next**, then click **Install Now** + + 10. If prompted, click **I don't have a product key**, as Windows will activate automatically later (as long as you have previously activated Windows legitimately) + + 11. Choose your Windows edition + +--8<-- "installation.md:atlasEditions" + + + + 1. Accept the license agreement and click **Custom: Install Windows only (advanced)** + + 2. At the 'Where do you want to install Windows?' screen, choose one of the following: + + === "Keeping data (recommended)" + !!! note "Previous Windows data" + + + + - 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` + + === "Deleting data on one drive" + !!! danger "This permanently deletes data!" + Make sure to follow the instructions carefully to ensure you don't delete the wrong partitions. + + - Identify the drive number you want to install Windows to + - You can identify your drives by their total sizes + - One by one, carefully delete **your drive number's** disk partitions + - Select the unallocated space of your drive number + - Click **Next** + + === "Deleting data on all drives" + !!! danger "This permanently deletes data on all drives!" + + - One by one, delete each disk partition in the window + - Select the unallocated space of the drive you want to install Windows to + - You can identify your drives by their total sizes + - Click **Next** + + 3. Wait for Windows to install + + +## :material-cog: **4.** Initial setup (OOBE) + +This step is different than most Windows 11 installs due to AME's custom OOBE. Simply follow the instructions on screen + +!!! Warning + If asked to connect to the internet, please do so. AtlasOS requires aninternet connection to be properly installed without issues +!!! Warning + After this initial OOBE, your desktop will be similar to regular Windows 11. Please wait for the new user script to run before doing anything.
diff --git a/mkdocs.yml b/mkdocs.yml index 97203cd4..79fef0fa 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -28,7 +28,7 @@ nav: - Install: - Before Continuing: getting-started/install/before-continuing.md - Install with Playbook: getting-started/install/install-playbook.md - - Install with ISO Injection: getting-started/install/install-iso-injection.md + - Install with ISO Injection (EXPERIMENTAL): getting-started/install/install-iso-injection.md - Setting up Atlas: getting-started/install/setting-up.md - Upgrade: - Before Continuing: getting-started/upgrade/before-continuing.md From 8351ade18fa528080beaa84d18a90f61b13ceaf8 Mon Sep 17 00:00:00 2001 From: kamild_ Date: Tue, 21 Oct 2025 19:37:40 +0200 Subject: [PATCH 2/5] fix: formatting and typos --- .../install/install-iso-injection.md | 46 +++++++++---------- 1 file changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/getting-started/install/install-iso-injection.md b/docs/getting-started/install/install-iso-injection.md index ecc04d44..f5be5c4c 100644 --- a/docs/getting-started/install/install-iso-injection.md +++ b/docs/getting-started/install/install-iso-injection.md @@ -14,15 +14,16 @@ icon: material/disc-player This is a known issue with AME Wizard. Please do a [traditional playbook install](.\install-playbook.md) if you are not comfortable with this. Due to issues with ISOs, we recommend you use AME Wizard's ISO downloader -1. Open your web browser, search [`atlasos.net`](https://atlasos.net) +1. Open your web browser, search [`atlasos.net`](https://atlasos.net) 1. On the website, click 'Get started', then click **-> Already following the guide?** at the bottom of the pop-up, and download the **Atlas Playbook** and **AME Wizard** 1. Extract both downloads to your desktop 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/ame.md#why-is-ame-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. Click on the **More Options** tab on the left side of the window -2. Select **Download ISO** and make sure **Windows 11** is selected, then click **Ok** +1. Select **Download ISO** and make sure **Windows 11** is selected, then click **OK**. + This should download a Windows 11 25H2 ISO.
\ No newline at end of file + From aefd86b4a12c4b5eaee77b6d06ec183b2c19dc77 Mon Sep 17 00:00:00 2001 From: Creeper <98064234+TheyCreeper@users.noreply.github.com> Date: Mon, 27 Oct 2025 08:39:26 -0400 Subject: [PATCH 3/5] feat: updated ISO injection docs --- .../install/install-iso-injection.md | 82 ++++++++++--------- 1 file changed, 43 insertions(+), 39 deletions(-) diff --git a/docs/getting-started/install/install-iso-injection.md b/docs/getting-started/install/install-iso-injection.md index f5be5c4c..3e90b1d2 100644 --- a/docs/getting-started/install/install-iso-injection.md +++ b/docs/getting-started/install/install-iso-injection.md @@ -2,47 +2,27 @@ description: Install AtlasOS using the ISO injection method for experienced users icon: material/disc-player --- + ## :material-disc: **1.** Download an ISO -!!! danger "ISO Injection with non-english ISOs break the administrator account" - This is a known issue with AME Wizard. Please download your ISO using AME Wizard, or download an english ISO using our alternatives. - -!!! danger "ISO Injection currently disables Ctrl+Alt+Del keybind" - This is a known issue with AME Wizard. Please do a [traditional playbook install](.\install-playbook.md) if you are not comfortable with this. +You will need to download an ISO before you can inject the playbook. -Due to issues with ISOs, we recommend you use AME Wizard's ISO downloader - -1. Open your web browser, search [`atlasos.net`](https://atlasos.net) -1. On the website, click 'Get started', then click **-> Already following the guide?** at the bottom of the pop-up, and download the **Atlas Playbook** and **AME Wizard** -1. Extract both downloads to your desktop -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/ame.md#why-is-ame-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. Click on the **More Options** tab on the left side of the window -1. Select **Download ISO** and make sure **Windows 11** is selected, then click **OK**. +Choose your desired Windows version's ISO file, which will be used later in the guide. -This should download a Windows 11 25H2 ISO. +The buttons below download an ISO directly from Microsoft's servers. It gets the latest version of your desired Windows version for [Intel, AMD, and ARM CPUs](https://www.tenforums.com/tutorials/132836-check-what-processor-cpu-windows-pc.html#option1). - - ??? grey-tip "Alternatives" - !!! tip - Even though the downloader in our docs uses official Microsoft servers, you can still download the ISO directly from their website. - - === "Classic ISO downloader (MSDL)" - Due to issues with non-english ISOs, we highly recommend you use AME Wizard's built-in downloader. - - If you still wish to use the classic ISO downloader, - please go to the [traditional playbook install](.\install-playbook.md) page and download an **english ISO** there, then come back here. + !!! tip + Even though the downloader in our docs uses official Microsoft servers, you can still download the ISO directly from their website or from AME directly. === "Official Microsoft Sources" @@ -53,20 +33,43 @@ See the alternatives below. - Select your desired language and press **Confirm**. - Click **64-bit Download** to begin your download. + === "AME Wizard's ISO dowloader" + 1. Open your web browser, search [`atlasos.net`](https://atlasos.net) + 1. On the website, click 'Get started', then click **-> Already following the guide?** at the bottom of the pop-up, and download the **Atlas Playbook** and **AME Wizard** + 1. Extract both downloads to your desktop + 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/ame.md#why-is-ame-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. Click on the **More Options** tab on the left side of the window + 1. Select **Download ISO** and make sure **Windows 11** is selected, then click **OK**. + + This should download a Windows 11 25H2 ISO. + +{% include 'msdl.md' %} + ## :material-file-edit: Injecting the playbook + +1. Open your web browser, search [`atlasos.net`](https://atlasos.net) +1. On the website, click 'Get started', then click **-> Already following the guide?** at the bottom of the pop-up, and download the **Atlas Playbook** and **AME Wizard** +1. Extract both downloads to your desktop +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/ame.md#why-is-ame-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 the previously downloaded ISO file into AME Wizard 1. Drag `Atlas Playbook.apbx` from your desktop into AME Wizard -2. Select the Windows 11 ISO previously downloaded -3. Click on the **Select a playbook to modify** +2. Select the Windows 11 ISO from the left side +3. Click on the **Select a playbook to modify** button 4. Make sure AtlasOS is selected, and click **Ok** 5. Click next when you see **AtlasOS Playbook selected** 6. Select all the options you would normally choose when installing AtlasOS playbook 7. At the end, you will be prompted to select which drivers you want to come with the ISO, we recommend keeping **Include additional network drivers** selected -8. Click **Next**. You will be asked to choose an username and a password for the user account - provide them and then click **Next**. *If you do not want a password, leave the box empty* +8. Click **Next**. You will be asked to choose an username and a password for the user account - provide them and then click **Next**. _If you do not want a password, leave the box empty_ 9. Wait for the injection to finish + ## :material-microsoft-windows: **3.** Reinstalling Windows Before continuing, we **strongly** recommend you back up any valuable data to an external drive or [a cloud service](before-continuing.md). @@ -120,10 +123,10 @@ Before continuing, we **strongly** recommend you back up any valuable data to an This method works on Linux and Windows. - !!! tip + !!! tip Even thought this method works on both Linux and Windows, please note that AME Wizard and ISO Injection only works in Windows. - 1. Download the latest release of [Ventoy :material-download:](https://github.com/ventoy/Ventoy/releases/) and extract it wherever you feel comfortable. + 1. Download the latest release of [Ventoy :material-download:](https://github.com/ventoy/Ventoy/releases/) and extract it wherever you feel comfortable. - Linux users can get it using a package manager 2. Inside the Ventoy folder, run **Ventoy2Disk** @@ -145,7 +148,7 @@ Before continuing, we **strongly** recommend you back up any valuable data to an

Credit to [Ventoy](https://ventoy.net/doc_secure.html) for the video demonstration.

- + ![vtoy-verification-error-0x1A](/assets/images/vtoy-secure-error.png){ align=right width=200 } If you get an error screen saying there was a 'Security Violation,' follow the steps below: @@ -155,7 +158,7 @@ Before continuing, we **strongly** recommend you back up any valuable data to an 2\. Press any key to begin key management 3\. Choose **Enroll Key From Disk** - + - The controls are arrow keys to move and ++enter++ to select 4\. Choose `VTOYEFI` @@ -163,7 +166,7 @@ Before continuing, we **strongly** recommend you back up any valuable data to an 5\. Choose `ENROLL_THIS_KEY_IN_MOKMANAGER.cer` 6\. Choose **Continue**, then **Yes**, and finally **Reboot** - + 7\. Boot from the USB again, as the issue should be resolved ------ @@ -180,6 +183,7 @@ Before continuing, we **strongly** recommend you back up any valuable data to an 11. Choose your Windows edition + --8<-- "installation.md:atlasEditions" @@ -213,8 +217,9 @@ Before continuing, we **strongly** recommend you back up any valuable data to an - Select the unallocated space of the drive you want to install Windows to - You can identify your drives by their total sizes - Click **Next** - + 3. Wait for Windows to install + ## :material-cog: **4.** Initial setup (OOBE) @@ -222,13 +227,12 @@ Before continuing, we **strongly** recommend you back up any valuable data to an This step is different than most Windows 11 installs due to AME's custom OOBE. Simply follow the instructions on screen !!! Warning - If asked to connect to the internet, please do so. AtlasOS requires an internet connection to be properly installed without issues +If asked to connect to the internet, please do so. AtlasOS requires an internet connection to be properly installed without issues !!! Warning - After this initial OOBE, your desktop will be similar to regular Windows 11. Please wait for the new user script to run before doing anything. - +After this initial OOBE, your desktop will be similar to regular Windows 11. Please wait for the new user script to run before doing anything.

-- #### Next: **[-> Setting up Atlas](setting-up.md)** +- #### Next: **[-> Setting up Atlas](setting-up.md)**
From 1e7882854e25595069aaf25b31866b7a54e9378c Mon Sep 17 00:00:00 2001 From: PencilNavigator <85282140+pencilnav@users.noreply.github.com> Date: Mon, 5 Jan 2026 00:32:11 +0800 Subject: [PATCH 4/5] fix: file paths --- .../install/install-iso-injection.md | 32 ++++++++++++------- 1 file changed, 21 insertions(+), 11 deletions(-) diff --git a/docs/getting-started/install/install-iso-injection.md b/docs/getting-started/install/install-iso-injection.md index 3e90b1d2..623c8202 100644 --- a/docs/getting-started/install/install-iso-injection.md +++ b/docs/getting-started/install/install-iso-injection.md @@ -12,7 +12,7 @@ You will need to download an ISO before you can inject the playbook. Choose 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, AMD, and ARM CPUs](https://www.tenforums.com/tutorials/132836-check-what-processor-cpu-windows-pc.html#option1). +The buttons below download an ISO directly from Microsoft's servers. They get the latest version of your desired Windows version for [Intel, AMD, and ARM CPUs](https://www.tenforums.com/tutorials/132836-check-what-processor-cpu-windows-pc.html#option1).