diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
index 74435ea5..2d1312cc 100644
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -18,8 +18,8 @@ We use the [Insiders edition of Material for MkDocs](https://squidfunk.github.io
## Issues
-If you find any issues with our documentation, please open an issue [here](https://github.com/Atlas-OS/docs/issues/new). Please fill issues out with utmost detail and preferably images too so we can understand where we went wrong or so contributors can make a pull request to fix the issue.
+If you find any issues with our documentation, please [open an issue](https://github.com/Atlas-OS/docs/issues/new). Please fill issues out with utmost detail and preferably images too so we can understand where we went wrong or so contributors can make a pull request to fix the issue.
## More help?
-You can follow the [GitHub docs contributing guide](https://github.com/github/docs/blob/main/CONTRIBUTING.md) for more help. You can also ask in our [Discord server](https://discord.atlasos.net) for more help as well.
\ No newline at end of file
+You can follow the [GitHub docs contributing guide](https://github.com/github/docs/blob/main/CONTRIBUTING.md) for more help. You can also ask in our [Discord server](https://discord.atlasos.net) for more help as well.
diff --git a/.gitignore b/.gitignore
index 4f307e3a..da2e4efb 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,16 +1,23 @@
# Directories
.cache/
site/
+.jampack/
+
+# Dependencies
+node_modules/
+
+# Logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
# MacOS related
.DS_Store
.AppleDouble
.LSOverride
-
Icon
-
._*
-
.DocumentRevisions-V100
.fseventsd
.Spotlight-V100
@@ -18,7 +25,6 @@ Icon
.Trashes
.VolumeIcon.icns
.com.apple.timemachine.donotpresent
-
.AppleDB
.AppleDesktop
Network Trash Folder
diff --git a/README.md b/README.md
index b043155c..0af5c2f1 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,6 @@ Here you can help Atlas with documentation, for now we do not have translation c
As MkDocs uses Python, you will need to have Python and pip installed, we recommend using [Scoop](https://scoop.sh) or [Chocolatey](https://chocolatey.org) to install these but you can also install via [Python's website](https://www.python.org).
-Material for MkDocs has already made a page, which you can use for Installation of Material for MkDocs [here](https://squidfunk.github.io/mkdocs-material/getting-started).
+Material for MkDocs has already made a page, which you can use for [Installation of Material for MkDocs](https://squidfunk.github.io/mkdocs-material/getting-started).
-Depending if you installed it locally or via a virtual envioronment, there is already a guide on previewing [here](https://squidfunk.github.io/mkdocs-material/creating-your-site/#previewing-as-you-write)
+Depending if you installed it locally or via a virtual envioronment, there is already a [guide on previewing](https://squidfunk.github.io/mkdocs-material/creating-your-site/#previewing-as-you-write)
diff --git a/docs/assets/brand/preview/icons/preview-icon-black.png b/docs/assets/brand/preview/icons/preview-icon-black.png
new file mode 100644
index 00000000..022fe6c9
Binary files /dev/null and b/docs/assets/brand/preview/icons/preview-icon-black.png differ
diff --git a/docs/assets/brand/preview/icons/preview-icon-cloud.png b/docs/assets/brand/preview/icons/preview-icon-cloud.png
new file mode 100644
index 00000000..1d5f153f
Binary files /dev/null and b/docs/assets/brand/preview/icons/preview-icon-cloud.png differ
diff --git a/docs/assets/brand/preview/icons/preview-icon-ice.png b/docs/assets/brand/preview/icons/preview-icon-ice.png
new file mode 100644
index 00000000..14608212
Binary files /dev/null and b/docs/assets/brand/preview/icons/preview-icon-ice.png differ
diff --git a/docs/assets/brand/preview/icons/preview-icon-night.png b/docs/assets/brand/preview/icons/preview-icon-night.png
new file mode 100644
index 00000000..f8221184
Binary files /dev/null and b/docs/assets/brand/preview/icons/preview-icon-night.png differ
diff --git a/docs/assets/brand/preview/icons/preview-icon-white.png b/docs/assets/brand/preview/icons/preview-icon-white.png
new file mode 100644
index 00000000..ab309bda
Binary files /dev/null and b/docs/assets/brand/preview/icons/preview-icon-white.png differ
diff --git a/docs/assets/brand/preview/logomark/preview-logomark-black.png b/docs/assets/brand/preview/logomark/preview-logomark-black.png
new file mode 100644
index 00000000..f8adf8ee
Binary files /dev/null and b/docs/assets/brand/preview/logomark/preview-logomark-black.png differ
diff --git a/docs/assets/brand/preview/logomark/preview-logomark-ice-black.png b/docs/assets/brand/preview/logomark/preview-logomark-ice-black.png
new file mode 100644
index 00000000..915e3d90
Binary files /dev/null and b/docs/assets/brand/preview/logomark/preview-logomark-ice-black.png differ
diff --git a/docs/assets/brand/preview/logomark/preview-logomark-ice-white.png b/docs/assets/brand/preview/logomark/preview-logomark-ice-white.png
new file mode 100644
index 00000000..db86f943
Binary files /dev/null and b/docs/assets/brand/preview/logomark/preview-logomark-ice-white.png differ
diff --git a/docs/assets/brand/preview/logomark/preview-logomark-ice.png b/docs/assets/brand/preview/logomark/preview-logomark-ice.png
new file mode 100644
index 00000000..74eb5148
Binary files /dev/null and b/docs/assets/brand/preview/logomark/preview-logomark-ice.png differ
diff --git a/docs/assets/brand/preview/logomark/preview-logomark-white.png b/docs/assets/brand/preview/logomark/preview-logomark-white.png
new file mode 100644
index 00000000..935ad383
Binary files /dev/null and b/docs/assets/brand/preview/logomark/preview-logomark-white.png differ
diff --git a/docs/assets/brand/preview/wordmark/preview-wordmark-black.png b/docs/assets/brand/preview/wordmark/preview-wordmark-black.png
new file mode 100644
index 00000000..a43b26cc
Binary files /dev/null and b/docs/assets/brand/preview/wordmark/preview-wordmark-black.png differ
diff --git a/docs/assets/brand/preview/wordmark/preview-wordmark-clouds.png b/docs/assets/brand/preview/wordmark/preview-wordmark-clouds.png
new file mode 100644
index 00000000..1191cf06
Binary files /dev/null and b/docs/assets/brand/preview/wordmark/preview-wordmark-clouds.png differ
diff --git a/docs/assets/brand/preview/wordmark/preview-wordmark-ice.png b/docs/assets/brand/preview/wordmark/preview-wordmark-ice.png
new file mode 100644
index 00000000..e6452e06
Binary files /dev/null and b/docs/assets/brand/preview/wordmark/preview-wordmark-ice.png differ
diff --git a/docs/assets/brand/preview/wordmark/preview-wordmark-night.png b/docs/assets/brand/preview/wordmark/preview-wordmark-night.png
new file mode 100644
index 00000000..539f8b37
Binary files /dev/null and b/docs/assets/brand/preview/wordmark/preview-wordmark-night.png differ
diff --git a/docs/assets/brand/preview/wordmark/preview-wordmark-white.png b/docs/assets/brand/preview/wordmark/preview-wordmark-white.png
new file mode 100644
index 00000000..7f9b904c
Binary files /dev/null and b/docs/assets/brand/preview/wordmark/preview-wordmark-white.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/generic/preview/Wallpapper 16_9 - Clouds Wordmark-preview.png b/docs/assets/brand/wallpapers/16_9/generic/preview/Wallpapper 16_9 - Clouds Wordmark-preview.png
new file mode 100644
index 00000000..4432e4f1
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/generic/preview/Wallpapper 16_9 - Clouds Wordmark-preview.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/generic/preview/Wallpapper 16_9 - Ice Wordmark-preview.png b/docs/assets/brand/wallpapers/16_9/generic/preview/Wallpapper 16_9 - Ice Wordmark-preview.png
new file mode 100644
index 00000000..30a2b677
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/generic/preview/Wallpapper 16_9 - Ice Wordmark-preview.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/generic/preview/Wallpapper 16_9 - Night Pride-preview.png b/docs/assets/brand/wallpapers/16_9/generic/preview/Wallpapper 16_9 - Night Pride-preview.png
new file mode 100644
index 00000000..9ff75666
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/generic/preview/Wallpapper 16_9 - Night Pride-preview.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/generic/preview/Wallpapper 16_9 - Night Wordmark-preview.png b/docs/assets/brand/wallpapers/16_9/generic/preview/Wallpapper 16_9 - Night Wordmark-preview.png
new file mode 100644
index 00000000..4897911f
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/generic/preview/Wallpapper 16_9 - Night Wordmark-preview.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/generic/preview/Wallpapper 16_9 - Setup-preview.png b/docs/assets/brand/wallpapers/16_9/generic/preview/Wallpapper 16_9 - Setup-preview.png
new file mode 100644
index 00000000..322fbcd2
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/generic/preview/Wallpapper 16_9 - Setup-preview.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/v0.3/v1/preview/Wallpapper 16_9 - v0.3 v2-preview.png b/docs/assets/brand/wallpapers/16_9/v0.3/v1/preview/Wallpapper 16_9 - v0.3 v2-preview.png
new file mode 100644
index 00000000..67f52ec6
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/v0.3/v1/preview/Wallpapper 16_9 - v0.3 v2-preview.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/v0.3/v1/preview/Wallpapper 16_9 - v0.3 v3-preview.png b/docs/assets/brand/wallpapers/16_9/v0.3/v1/preview/Wallpapper 16_9 - v0.3 v3-preview.png
new file mode 100644
index 00000000..7dba4557
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/v0.3/v1/preview/Wallpapper 16_9 - v0.3 v3-preview.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/v0.3/v1/preview/Wallpapper 16_9 - v0.3-preview.png b/docs/assets/brand/wallpapers/16_9/v0.3/v1/preview/Wallpapper 16_9 - v0.3-preview.png
new file mode 100644
index 00000000..42599154
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/v0.3/v1/preview/Wallpapper 16_9 - v0.3-preview.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/v0.3/v2/preview/Wallpapper 16_9 - v0.3 v4-preview.png b/docs/assets/brand/wallpapers/16_9/v0.3/v2/preview/Wallpapper 16_9 - v0.3 v4-preview.png
new file mode 100644
index 00000000..d8bd1812
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/v0.3/v2/preview/Wallpapper 16_9 - v0.3 v4-preview.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/v0.3/v2/preview/Wallpapper 16_9 - v0.3 v7-preview.png b/docs/assets/brand/wallpapers/16_9/v0.3/v2/preview/Wallpapper 16_9 - v0.3 v7-preview.png
new file mode 100644
index 00000000..39409412
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/v0.3/v2/preview/Wallpapper 16_9 - v0.3 v7-preview.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/v0.3/v3/preview/Wallpapper 16_9 - v0.3 v5-preview.png b/docs/assets/brand/wallpapers/16_9/v0.3/v3/preview/Wallpapper 16_9 - v0.3 v5-preview.png
new file mode 100644
index 00000000..acf7348e
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/v0.3/v3/preview/Wallpapper 16_9 - v0.3 v5-preview.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/v0.3/v3/preview/Wallpapper 16_9 - v0.3 v6-preview.png b/docs/assets/brand/wallpapers/16_9/v0.3/v3/preview/Wallpapper 16_9 - v0.3 v6-preview.png
new file mode 100644
index 00000000..89171c48
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/v0.3/v3/preview/Wallpapper 16_9 - v0.3 v6-preview.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/v0.3/v3/preview/Wallpapper 16_9 - v0.3 v8-preview.png b/docs/assets/brand/wallpapers/16_9/v0.3/v3/preview/Wallpapper 16_9 - v0.3 v8-preview.png
new file mode 100644
index 00000000..fb072e9b
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/v0.3/v3/preview/Wallpapper 16_9 - v0.3 v8-preview.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/v0.3/v3/preview/Wallpapper 16_9 - v0.3 v9-preview.png b/docs/assets/brand/wallpapers/16_9/v0.3/v3/preview/Wallpapper 16_9 - v0.3 v9-preview.png
new file mode 100644
index 00000000..8baa1383
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/v0.3/v3/preview/Wallpapper 16_9 - v0.3 v9-preview.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper 16_9 - v0.3 v10-preview.png b/docs/assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper 16_9 - v0.3 v10-preview.png
new file mode 100644
index 00000000..95cb527e
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper 16_9 - v0.3 v10-preview.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper 16_9 - v0.3 v11-preview.png b/docs/assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper 16_9 - v0.3 v11-preview.png
new file mode 100644
index 00000000..2d4522c2
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper 16_9 - v0.3 v11-preview.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper 16_9 - v0.3 v12-preview.png b/docs/assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper 16_9 - v0.3 v12-preview.png
new file mode 100644
index 00000000..b93abc4f
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper 16_9 - v0.3 v12-preview.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper 16_9 - v0.3 v13-preview.png b/docs/assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper 16_9 - v0.3 v13-preview.png
new file mode 100644
index 00000000..9437d7ff
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper 16_9 - v0.3 v13-preview.png differ
diff --git a/docs/assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper 16_9 - v0.3 v14-preview.png b/docs/assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper 16_9 - v0.3 v14-preview.png
new file mode 100644
index 00000000..f6348585
Binary files /dev/null and b/docs/assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper 16_9 - v0.3 v14-preview.png differ
diff --git a/docs/assets/images/atlasdesktop-windows-folder.png b/docs/assets/images/atlasdesktop-windows-folder.png
new file mode 100644
index 00000000..a94f4156
Binary files /dev/null and b/docs/assets/images/atlasdesktop-windows-folder.png differ
diff --git a/docs/assets/images/bitlocker-decryption-progress.png b/docs/assets/images/bitlocker-decryption-progress.png
new file mode 100644
index 00000000..6145727a
Binary files /dev/null and b/docs/assets/images/bitlocker-decryption-progress.png differ
diff --git a/docs/assets/images/bitlocker-error-decrypting.jpg b/docs/assets/images/bitlocker-error-decrypting.jpg
new file mode 100644
index 00000000..6f86b67d
Binary files /dev/null and b/docs/assets/images/bitlocker-error-decrypting.jpg differ
diff --git a/docs/assets/images/bitlocker-error-setup.jpg b/docs/assets/images/bitlocker-error-setup.jpg
new file mode 100644
index 00000000..423cf5c9
Binary files /dev/null and b/docs/assets/images/bitlocker-error-setup.jpg differ
diff --git a/docs/assets/images/bluetooth-script-folder.png b/docs/assets/images/bluetooth-script-folder.png
new file mode 100644
index 00000000..de1859f3
Binary files /dev/null and b/docs/assets/images/bluetooth-script-folder.png differ
diff --git a/docs/assets/images/device-manager-nic.png b/docs/assets/images/device-manager-nic.png
new file mode 100644
index 00000000..8d1a558e
Binary files /dev/null and b/docs/assets/images/device-manager-nic.png differ
diff --git a/docs/assets/images/discord-development-role.png b/docs/assets/images/discord-development-role.png
new file mode 100644
index 00000000..1b580d0a
Binary files /dev/null and b/docs/assets/images/discord-development-role.png differ
diff --git a/docs/assets/images/printer-script-folder.png b/docs/assets/images/printer-script-folder.png
new file mode 100644
index 00000000..8cbc5510
Binary files /dev/null and b/docs/assets/images/printer-script-folder.png differ
diff --git a/docs/assets/videos/check-gpt-mbr.mp4 b/docs/assets/videos/check-gpt-mbr.mp4
index 0a449aa9..dda039c7 100644
Binary files a/docs/assets/videos/check-gpt-mbr.mp4 and b/docs/assets/videos/check-gpt-mbr.mp4 differ
diff --git a/docs/assets/videos/win10-OOBE.mp4 b/docs/assets/videos/win10-OOBE.mp4
new file mode 100644
index 00000000..28b19ac9
Binary files /dev/null and b/docs/assets/videos/win10-OOBE.mp4 differ
diff --git a/docs/assets/videos/win11-OOBE-nointernet.mp4 b/docs/assets/videos/win11-OOBE-nointernet.mp4
new file mode 100644
index 00000000..b10a9149
Binary files /dev/null and b/docs/assets/videos/win11-OOBE-nointernet.mp4 differ
diff --git a/docs/assets/videos/win11-OOBE.mp4 b/docs/assets/videos/win11-OOBE.mp4
new file mode 100644
index 00000000..739e6ba1
Binary files /dev/null and b/docs/assets/videos/win11-OOBE.mp4 differ
diff --git a/docs/branding.md b/docs/branding.md
new file mode 100644
index 00000000..4d45399e
--- /dev/null
+++ b/docs/branding.md
@@ -0,0 +1,426 @@
+---
+description: See the official branding & wallpapers for AtlasOS
+icon: material/palette
+---
+
+# Official AtlasOS Branding
+
+You can use the official AtlasOS branding to show your support for AtlasOS whether you're making a video, a website, or a presentation.
+
+We make all of our brand assets available to the public in a variety of formats and sizes, allowing you to use them however you see fit. You can either make cool fan art or use it in your AtlasOS video reviews. The only limit is your imagination!
+
+!!! info "Remember the brand rules"
+
+ Please read our [Brand Guidelines](https://gcore.jsdelivr.net/gh/Atlas-OS/Atlas@main/img/Atlas%20-%20Brand%20Guidelines.pdf) for instructions on how to properly apply all of our various branding assets when applying the AtlasOS branding.
+
+## Logomarks
+
+=== "Ice"
+
+ { width=250 loading=lazy }
+
+ *Ice Logomark*
+
+ [:material-download: Download Ice Logomark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/ice/Logomark%20-%20Ice%20Ice.png)
+
+ [:material-download: Download Ice Logomark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/ice/Logomark%20-%20Ice%20Ice.svg)
+
+ [:material-download: Download Ice Logomark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/ice/Logomark%20-%20Ice%20Ice.pdf)
+
+ { width=250 loading=lazy }
+
+ *Ice + White Logomark*
+
+ [:material-download: Download Ice + White Logomark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/ice/Logomark%20-%20Ice%20White.png)
+
+ [:material-download: Download Ice + White Logomark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/ice/Logomark%20-%20Ice%20White.svg)
+
+ [:material-download: Download Ice + White Logomark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/ice/Logomark%20-%20Ice%20White.pdf)
+
+ { width=250 loading=lazy }
+
+ *Ice + Black Logomark*
+
+ [:material-download: Download Ice + Black Logomark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/ice/Logomark%20-%20Ice%20Black.png)
+
+ [:material-download: Download Ice + Black Logomark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/ice/Logomark%20-%20Ice%20Black.svg)
+
+ [:material-download: Download Ice + Black Logomark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/ice/Logomark%20-%20Ice%20Black.pdf)
+
+=== "Black & White"
+
+ { width=250 loading=lazy }
+
+ *White Logomark*
+
+ [:material-download: Download White Logomark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/white/Logomark%20-%20White%20White.png)
+
+ [:material-download: Download White Logomark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/white/Logomark%20-%20White%20White.svg)
+
+ [:material-download: Download White Logomark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/white/Logomark%20-%20White%20White.pdf)
+
+ { width=250 loading=lazy }
+
+ *Black Logomark*
+
+ [:material-download: Download Black Logomark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/black/Logomark%20-%20Black%20Black.png)
+
+ [:material-download: Download Black Logomark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/black/Logomark%20-%20Black%20Black.svg)
+
+ [:material-download: Download Black Logomark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/black/Logomark%20-%20Black%20Black.pdf)
+
+## Wordmarks
+
+=== "Atlas Colors"
+
+ { width=250 loading=lazy }
+
+ *Ice Wordmark*
+
+ [:material-download: Download Ice Wordmark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/official/Wordmark%20-%20Ice.png)
+
+ [:material-download: Download Ice Wordmark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/official/Wordmark%20-%20Ice.svg)
+
+ [:material-download: Download Ice Wordmark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/official/Wordmark%20-%20Ice.pdf)
+
+ { width=250 loading=lazy }
+
+ *Clouds Wordmark*
+
+ [:material-download: Download Clouds Wordmark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/official/Wordmark%20-%20Clouds.png)
+
+ [:material-download: Download Clouds Wordmark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/official/Wordmark%20-%20Clouds.svg)
+
+ [:material-download: Download Clouds Wordmark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/official/Wordmark%20-%20Clouds.pdf)
+
+ { width=250 loading=lazy }
+
+ *Night Wordmark*
+
+ [:material-download: Download Night Wordmark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/official/Wordmark%20-%20Night.png)
+
+ [:material-download: Download Night Wordmark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/official/Wordmark%20-%20Night.svg)
+
+ [:material-download: Download Night Wordmark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/official/Wordmark%20-%20Night.pdf)
+
+=== "Black & White"
+
+ { width=250 loading=lazy }
+
+ *White Wordmark*
+
+ [:material-download: Download White Wordmark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/white/Wordmark%20-%20White.png)
+
+ [:material-download: Download White Wordmark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/white/Wordmark%20-%20White.svg)
+
+ [:material-download: Download White Wordmark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/white/Wordmark%20-%20White.pdf)
+
+ { width=250 loading=lazy }
+
+ *Black Wordmark*
+
+ [:material-download: Download Black Wordmark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/black/Wordmark%20-%20Black.png)
+
+ [:material-download: Download Black Wordmark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/black/Wordmark%20-%20Black.svg)
+
+ [:material-download: Download Black Wordmark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/black/Wordmark%20-%20Black.pdf)
+
+## Icon
+
+=== "Atlas Colors"
+
+ { width=128 loading=lazy }
+
+ *Ice Icon*
+
+ [:material-download: Download Ice Icon .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/official/Icon%20-%20Ice.png)
+
+ [:material-download: Download Ice Icon .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/official/Icon%20-%20Ice.svg)
+
+ [:material-download: Download Ice Icon .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/official/Icon%20-%20Ice.pdf)
+
+ { width=128 loading=lazy }
+
+ *Clouds Icon*
+
+ [:material-download: Download Clouds Icon .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/official/Icon%20-%20Clouds.png)
+
+ [:material-download: Download Clouds Icon .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/official/Icon%20-%20Clouds.svg)
+
+ [:material-download: Download Clouds Icon .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/official/Icon%20-%20Clouds.pdf)
+
+ { width=128 loading=lazy }
+
+ *Night Icon*
+
+ [:material-download: Download Night Icon .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/official/Icon%20-%20Night.png)
+
+ [:material-download: Download Night Icon .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/official/Icon%20-%20Night.svg)
+
+ [:material-download: Download Night Icon .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/official/Icon%20-%20Night.pdf)
+
+=== "Black & White"
+
+ { width=128 loading=lazy }
+
+ *White Icon*
+
+ [:material-download: Download White Icon .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/white/Icon%20-%20White.png)
+
+ [:material-download: Download White Icon .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/white/Icon%20-%20White.svg)
+
+ [:material-download: Download White Icon .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/white/Icon%20-%20White.pdf)
+
+ { width=128 loading=lazy }
+
+ *Black Icon*
+
+ [:material-download: Download Black Icon .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/black/Icon%20-%20Black.png)
+
+ [:material-download: Download Black Icon .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/black/Icon%20-%20Black.svg)
+
+ [:material-download: Download Black Icon .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/black/Icon%20-%20Black.pdf)
+
+## Wallpapers
+
+### Atlas v0.3
+
+#### Version 1
+
+=== "v0.3 Version 1"
+
+ { width=650 loading=lazy }
+
+ [:material-download: Download v0.3 Version 1 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v1/Wallpapper%2016_9%20-%20v0.3.png)
+
+ [:material-download: Downlhoad v0.3 Version 1 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v1/Wallpapper%2016_10%20-%20v0.3.png)
+
+ [:material-download: Download v0.3 Version 1 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v1/Wallpapper%2021_9%20-%20v0.3.png)
+
+ [:material-download: Download v0.3 Version 1 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v1/Wallpapper%204_3%20-%20v0.3.png)
+
+=== "v0.3 Version 1.1"
+
+ { width=650 loading=lazy }
+
+ [:material-download: Download v0.3 Version 1.1 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v1/Wallpapper%2016_9%20-%20v0.3%20v2.png)
+
+ [:material-download: Download v0.3 Version 1.1 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v1/Wallpapper%2016_10%20-%20v0.3%20v2.png)
+
+ [:material-download: Download v0.3 Version 1.1 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v1/Wallpapper%2021_9%20-%20v0.3%20v2.png)
+
+ [:material-download: Download v0.3 Version 1.1 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v1/Wallpapper%204_3%20-%20v0.3%20v2.png)
+
+=== "v0.3 Version 1.2"
+
+ { width=650 loading=lazy }
+
+ [:material-download: Download v0.3 Version 1.2 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v1/Wallpapper%2016_9%20-%20v0.3%20v3.png)
+
+ [:material-download: Download v0.3 Version 1.2 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v1/Wallpapper%2016_10%20-%20v0.3%20v3.png)
+
+ [:material-download: Download v0.3 Version 1.2 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v1/Wallpapper%2021_9%20-%20v0.3%20v3.png)
+
+ [:material-download: Download v0.3 Version 1.2 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v1/Wallpapper%204_3%20-%20v0.3%20v3.png)
+
+#### Version 2
+
+=== "v0.3 Version 2"
+
+ { width=650 loading=lazy }
+
+ [:material-download: Download v0.3 Version 2 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v2/Wallpapper%2016_9%20-%20v0.3%20v4.png)
+
+ [:material-download: Download v0.3 Version 2 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v2/Wallpapper%2016_10%20-%20v0.3%20v4.png)
+
+ [:material-download: Download v0.3 Version 2 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v2/Wallpapper%2021_9%20-%20v0.3%20v4.png)
+
+ [:material-download: Download v0.3 Version 2 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v2/Wallpapper%2014_3%20-%20v0.3%20v4.png)
+
+=== "v0.3 Version 2.1"
+
+ { width=650 loading=lazy }
+
+ [:material-download: Download v0.3 Version 2.1 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v2/Wallpapper%2016_9%20-%20v0.3%20v7.png)
+
+ [:material-download: Download v0.3 Version 2.1 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v2/Wallpapper%2016_10%20-%20v0.3%20v7.png)
+
+ [:material-download: Download v0.3 Version 2.1 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v2/Wallpapper%2021_9%20-%20v0.3%20v7.png)
+
+ [:material-download: Download v0.3 Version 2.1 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v2/Wallpapper%2014_3%20-%20v0.3%20v7.png)
+
+#### Version 3
+
+=== "v0.3 Version 3"
+
+ { width=650 loading=lazy }
+
+ [:material-download: Download v0.3 Version 3 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v3/Wallpapper%2016_9%20-%20v0.3%20v5.png)
+
+ [:material-download: Download v0.3 Version 3 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v3/Wallpapper%2016_10%20-%20v0.3%20v5.png)
+
+ [:material-download: Download v0.3 Version 3 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v3/Wallpapper%2021_9%20-%20v0.3%20v5.png)
+
+ [:material-download: Download v0.3 Version 3 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v3/Wallpapper%204_3%20-%20v0.3%20v5.png)
+
+=== "v0.3 Version 3.1"
+
+ { width=650 loading=lazy }
+
+ [:material-download: Download v0.3 Version 3.1 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v3/Wallpapper%2016_9%20-%20v0.3%20v6.png)
+
+ [:material-download: Download v0.3 Version 3.1 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v3/Wallpapper%2016_10%20-%20v0.3%20v6.png)
+
+ [:material-download: Download v0.3 Version 3.1 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v3/Wallpapper%2021_9%20-%20v0.3%20v6.png)
+
+ [:material-download: Download v0.3 Version 3.1 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v3/Wallpapper%204_3%20-%20v0.3%20v6.png)
+
+=== "v0.3 Version 3.2"
+
+ { width=650 loading=lazy }
+
+ [:material-download: Download v0.3 Version 3.2 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v3/Wallpapper%2016_9%20-%20v0.3%20v8.png)
+
+ [:material-download: Download v0.3 Version 3.2 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v3/Wallpapper%2016_10%20-%20v0.3%20v8.png)
+
+ [:material-download: Download v0.3 Version 3.2 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v3/Wallpapper%2021_9%20-%20v0.3%20v8.png)
+
+ [:material-download: Download v0.3 Version 3.2 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v3/Wallpapper%204_3%20-%20v0.3%20v8.png)
+
+=== "v0.3 Version 3.3"
+
+ { width=650 loading=lazy }
+
+ [:material-download: Download v0.3 Version 3.3 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v3/Wallpapper%2016_9%20-%20v0.3%20v9.png)
+
+ [:material-download: Download v0.3 Version 3.3 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v3/Wallpapper%2016_10%20-%20v0.3%20v9.png)
+
+ [:material-download: Download v0.3 Version 3.3 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v3/Wallpapper%2021_9%20-%20v0.3%20v9.png)
+
+ [:material-download: Download v0.3 Version 3.3 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v3/Wallpapper%204_3%20-%20v0.3%20v9.png)
+
+#### Version 4
+
+=== "v0.3 Version 4"
+
+ { width=650 loading=lazy }
+
+ [:material-download: Download v0.3 Version 4 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v4/Wallpapper%2016_9%20-%20v0.3%20v10.png)
+
+ [:material-download: Download v0.3 Version 4 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v4/Wallpapper%2016_10%20-%20v0.3%20v10.png)
+
+ [:material-download: Download v0.3 Version 4 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v4/Wallpapper%2021_9%20-%20v0.3%20v10.png)
+
+ [:material-download: Download v0.3 Version 4 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v4/Wallpapper%204_3%20-%20v0.3%20v10.png)
+
+=== "v0.3 Version 4.1"
+
+ { width=650 loading=lazy }
+
+ [:material-download: Download v0.3 Version 4.1 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v4/Wallpapper%2016_9%20-%20v0.3%20v11.png)
+
+ [:material-download: Download v0.3 Version 4.1 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v4/Wallpapper%2016_10%20-%20v0.3%20v11.png)
+
+ [:material-download: Download v0.3 Version 4.1 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v4/Wallpapper%2021_9%20-%20v0.3%20v11.png)
+
+ [:material-download: Download v0.3 Version 4.1 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v4/Wallpapper%204_3%20-%20v0.3%20v11.png)
+
+=== "v0.3 Version 4.2"
+
+ { width=650 loading=lazy }
+
+ [:material-download: Download v0.3 Version 4.2 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v4/Wallpapper%2016_9%20-%20v0.3%20v12.png)
+
+ [:material-download: Download v0.3 Version 4.2 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v4/Wallpapper%2016_10%20-%20v0.3%20v12.png)
+
+ [:material-download: Download v0.3 Version 4.2 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v4/Wallpapper%2021_9%20-%20v0.3%20v12.png)
+
+ [:material-download: Download v0.3 Version 4.2 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v4/Wallpapper%204_3%20-%20v0.3%20v12.png)
+
+=== "v0.3 Version 4.3"
+
+ { width=650 loading=lazy }
+
+ [:material-download: Download v0.3 Version 4.3 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v4/Wallpapper%2016_9%20-%20v0.3%20v13.png)
+
+ [:material-download: Download v0.3 Version 4.3 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v4/Wallpapper%2016_10%20-%20v0.3%20v13.png)
+
+ [:material-download: Download v0.3 Version 4.3 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v4/Wallpapper%2021_9%20-%20v0.3%20v13.png)
+
+ [:material-download: Download v0.3 Version 4.3 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v4/Wallpapper%204_3%20-%20v0.3%20v13.png)
+
+=== "v0.3 Version 4.4"
+
+ { width=650 loading=lazy }
+
+ [:material-download: Download v0.3 Version 4.4 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v4/Wallpapper%2016_9%20-%20v0.3%20v14.png)
+
+ [:material-download: Download v0.3 Version 4.4 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v4/Wallpapper%2016_10%20-%20v0.3%20v14.png)
+
+ [:material-download: Download v0.3 Version 4.4 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v4/Wallpapper%2021_9%20-%20v0.3%20v14.png)
+
+ [:material-download: Download v0.3 Version 4.4 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v4/Wallpapper%204_3%20-%20v0.3%20v14.png)
+
+### Generic
+
+=== "Ice Wordmark"
+
+ { width=650 loading=lazy }
+
+ [:material-download: Download Ice Wordmark Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/generic/Wallpapper%2016_9%20-%20Ice%20Wordmark.png)
+
+ [:material-download: Download Ice Wordmark Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/generic/Wallpapper%2016_10%20-%20Ice%20Wordmark.png)
+
+ [:material-download: Download Ice Wordmark Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/generic/Wallpapper%2021_9%20-%20Ice%20Wordmark.png)
+
+ [:material-download: Download Ice Wordmark Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/generic/Wallpapper%204_3%20-%20Ice%20Wordmark.png)
+
+=== "Clouds Wordmark"
+
+ { width=650 loading=lazy }
+
+ [:material-download: Download Clouds Wordmark Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/generic/Wallpapper%2016_9%20-%20Clouds%20Wordmark.png)
+
+ [:material-download: Download Clouds Wordmark Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/generic/Wallpapper%2016_10%20-%20Clouds%20Wordmark.png)
+
+ [:material-download: Download Clouds Wordmark Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/generic/Wallpapper%2021_9%20-%20Clouds%20Wordmark.png)
+
+ [:material-download: Download Clouds Wordmark Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/generic/Wallpapper%204_3%20-%20Clouds%20Wordmark.png)
+
+=== "Night Wordmark"
+
+ { width=650 loading=lazy }
+
+ [:material-download: Download Night Wordmark Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/generic/Wallpapper%2016_9%20-%20Night%20Wordmark.png)
+
+ [:material-download: Download Night Wordmark Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/generic/Wallpapper%2016_10%20-%20Night%20Wordmark.png)
+
+ [:material-download: Download Night Wordmark Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_+/generic/Wallpapper%2021_9%20-%20Night%20Wordmark.png)
+
+ [:material-download: Download Night Wordmark Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/generic/Wallpapper%204_3%20-%20Night%20Wordmark.png)
+
+=== "Night Pride"
+
+ { width=650 loading=lazy }
+
+ [:material-download: Download Night Pride Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/generic/Wallpapper%2016_9%20-%20Night%20Pride.png)
+
+ [:material-download: Download Night Pride Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/generic/Wallpapper%2016_10%20-%20Night%20Pride.png)
+
+ [:material-download: Download Night Pride Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/generic/Wallpapper%2021_9%20-%20Night%20Pride.png)
+
+ [:material-download: Download Night Pride Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/generic/Wallpapper%204_3%20-%20Night%20Pride.png)
+
+=== "Setup"
+
+ { width=650 loading=lazy }
+
+ *Photo taken by [Roberto Nickson (@rpnickson)](https://unsplash.com/@rpnickson) via Unsplash.*
+
+ [:material-download: Download Setup Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/generic/Wallpapper%2016_9%20-%20Setup.png)
+
+ [:material-download: Download Setup Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/generic/Wallpapper%2016_10%20-%20Setup.png)
+
+ [:material-download: Download Setup Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/generic/Wallpapper%2021_9%20-%20Setup.png)
+
+ [:material-download: Download Setup Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/generic/Wallpapper%204_3%20-%20Setup.png)
diff --git a/docs/contributions.md b/docs/contributions.md
index 900e604d..9958e9a5 100644
--- a/docs/contributions.md
+++ b/docs/contributions.md
@@ -24,7 +24,7 @@ Alternatively, you can use the [Git](https://git-scm.com/) command-line. Use whi
* Read [this](https://github.com/Atlas-OS/docs/blob/master/.github/CONTRIBUTING.md) documentation-specific contribution guide as well as these contribution guidelines to setup a development environment
* Reading the [GitHub documentation contribution guide](https://github.com/github/docs/blob/main/CONTRIBUTING.md) might also be useful
-These are the main three repositories to contribute to. There might also be other repositories that you can contribute to, see [here](https://github.com/Atlas-OS).
+These are the main three repositories to contribute to. There might also may be other repositories that fits your expertise. [Check out our GitHub organisation](https://github.com/Atlas-OS).
If a repository has a specified template for pull requests or issues, please use them. Otherwise, your pull request could be closed.
@@ -33,11 +33,11 @@ If a repository has a specified template for pull requests or issues, please use
There is a `dev` branch and a `main` or `master` branch for development on each repository.
!!! warning
- Make **all of your changes** to the `dev` branch of the respective repositories!
+ Make **all of your changes** to the `dev` branch of the respective repositories!
Never commit or pull request directly to the `main` branches, with the **only exception** being committing to the `main` branch on the main repository for translations.
-The reason why the `dev` branch exists is to ensure that the `main` branch only has approved and high quality changes.
+The reason why the `dev` branch exists is to ensure that the `main` branch only has approved and high quality changes.
A pull request **every week** will be automatically created to merge the `dev` branch into the `main` branch, where the changes can be properly reviewed by **5 contributors** before the pull request is merged. The only exclusion to having less than 5 reviews is if there's not enough people reviewing, e.g. 4 reviews for documentation.
@@ -49,12 +49,12 @@ You will have to make your own fork of the respective Atlas repository, and then
!!! note
This only applies to people with direct access to commit to the repositories, without the need to do a pull request.
-
- The list of people that have access is [here](https://github.com/orgs/Atlas-OS/people).
-If there's any big changes, you should instead make a pull request for `dev` instead of directly committing to it. Some examples of big changes could be mass formatting changes, feature changes, or anything similar.
+ This list is from [our GitHub organisation's member list](https://github.com/orgs/Atlas-OS/people).
-This means less potential headache in the future if the change is disagreed upon, as you can avoid reverting all of the disliked changes for the automatic pull request every week.
+If there's any big changes, you should instead make a pull request for `dev` instead of directly committing to it. Some examples of big changes could be mass formatting changes, feature changes, or anything similar.
+
+This means less potential headache in the future if the change is disagreed upon, as you can avoid reverting all of the disliked changes for the automatic pull request every week.
If you want to, you can also manually trigger the automatic pull request to merge `dev` into `main` early, but the 5 reviews will still be in effect. As a note, if you need to urgently fix something, you can use the `bypass` label to bypass your pull request being automatically closed by the pull request filter.
@@ -75,11 +75,11 @@ Making sure that your commits are already to a high standard means that developm
### :octicons-verified-16: Commit Signature Verification
It is also highly recommended to setup [commit signature verification](https://docs.github.com/en/authentication/managing-commit-signature-verification), which means that your commits will be marked as 'Verified' so that other people will know that your commits come from a trusted source.
-You can install [GPG](https://gnupg.org/) (used for signing) on Windows with [Scoop](https://scoop.sh/) with the following command:
+You can install [GPG](https://gnupg.org/) (used for signing) in Windows with [Scoop](https://scoop.sh/) with the following command:
```
scoop install gpg
```
-For a more simple guide, click [here](https://gist.github.com/Beneboe/3183a8a9eb53439dbee07c90b344c77e#file-how-to-setup-verified-commits-md).
+Check out this for a detailed [guide on setting up verified commits](https://gist.github.com/Beneboe/3183a8a9eb53439dbee07c90b344c77e#file-how-to-setup-verified-commits-md).
### :octicons-git-branch-16: Conventional Commits
@@ -88,4 +88,4 @@ Preferably use [Conventional Commits](https://www.conventionalcommits.org/) for
*Example*: [`feat: ✨ add fAllowFullControl`](https://github.com/Atlas-OS/Atlas/commit/72cdcc7b327df19fd07e9c6eb0a10812ac6936b0)
- [**Extension for Visual Studio Code**](https://github.com/vivaxy/vscode-conventional-commits)
-- [**Emoji reference**](https://gitmoji.dev) (optional)
\ No newline at end of file
+- [**Emoji reference**](https://gitmoji.dev) (optional)
diff --git a/docs/faq-and-troubleshooting/atlas-and-security.md b/docs/faq-and-troubleshooting/atlas-and-security.md
new file mode 100644
index 00000000..1bd4900f
--- /dev/null
+++ b/docs/faq-and-troubleshooting/atlas-and-security.md
@@ -0,0 +1,10 @@
+---
+description: How secure is AtlasOS?
+icon: material/shield
+---
+
+# How secure is Atlas?
+
+**Atlas is as secure as you want it to be, with the ability to enable or disable Defender, enable or disable Core isolation and Windows Update compatibility.**
+
+Atlas also does extra improvements to security within Windows by disabling various obselete and potentially vulnerable features.
diff --git a/docs/troubleshooting/scripts.md b/docs/faq-and-troubleshooting/atlas-folder-scripts.md
similarity index 100%
rename from docs/troubleshooting/scripts.md
rename to docs/faq-and-troubleshooting/atlas-folder-scripts.md
diff --git a/docs/faq-and-troubleshooting/common-questions/adobe-acrobat.md b/docs/faq-and-troubleshooting/common-questions/adobe-acrobat.md
new file mode 100644
index 00000000..f87f7943
--- /dev/null
+++ b/docs/faq-and-troubleshooting/common-questions/adobe-acrobat.md
@@ -0,0 +1,14 @@
+---
+description: How to fix Adobe Acrobat fails to install on AtlasOS
+icon: simple/adobe
+---
+
+# How to fix Adobe Acrobat not installing?
+
+**Printing must be enabled (via the Atlas folder) to install Adobe Acrobat correctly**
+
+This can be found in the Atlas folder, under configuration.
+
+This is because Adobe installs the "Adobe PDF" printer on your system. Adobe PDF is a printer driver that saves documents in a format called Adobe PDF.
+
+
diff --git a/docs/faq-and-troubleshooting/common-questions/ame-wizard-virus-detection.md b/docs/faq-and-troubleshooting/common-questions/ame-wizard-virus-detection.md
new file mode 100644
index 00000000..37fd2148
--- /dev/null
+++ b/docs/faq-and-troubleshooting/common-questions/ame-wizard-virus-detection.md
@@ -0,0 +1,12 @@
+---
+description: Why is AME Wizard being detected as a virus?
+icon: material/virus
+---
+
+# Why is AME Wizard being detected as a virus?
+
+**AME Wizard can be falsely flagged as a virus when a new version is published. To avoid it being detected, add it to your Windows Defender exclusions list.**
+
+Windows Security 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).
diff --git a/docs/faq-and-troubleshooting/common-questions/atlas-folder-missing.md b/docs/faq-and-troubleshooting/common-questions/atlas-folder-missing.md
new file mode 100644
index 00000000..46b856f6
--- /dev/null
+++ b/docs/faq-and-troubleshooting/common-questions/atlas-folder-missing.md
@@ -0,0 +1,12 @@
+---
+description: How to fix missing Atlas folder on AtlasOS
+icon: material/folder-question
+---
+
+# How to fix Atlas folder missing?
+
+**If there is not a shortcut for the folder on your desktop, you can find it here: `C:/Windows/AtlasDesktop`.**
+
+If you wish to have the folder on your desktop, instead of moving the main folder we recommend you create a shortcut and place it on your desktop.
+
+
diff --git a/docs/faq-and-troubleshooting/common-questions/atlas-iso-files.md b/docs/faq-and-troubleshooting/common-questions/atlas-iso-files.md
new file mode 100644
index 00000000..402871ae
--- /dev/null
+++ b/docs/faq-and-troubleshooting/common-questions/atlas-iso-files.md
@@ -0,0 +1,14 @@
+---
+description: Where can I find the Atlas ISO file?
+icon: material/disc
+---
+
+# Where is the Atlas ISO file?
+
+**Atlas doesn't have an ISO file. It uses AME Wizard to modify Windows on a new live installation, applying configurations like an ISO file.**
+
+Distributing ISO files violates Microsoft's EULA and poses safety risks due to uncertainty about the contents. We use AME Wizard and use releases directly from our GitHub. We also include a checksum in case you wish to verify the integrity of your download.
+
+> "For software downloads, unless expressly permitted in the accompanying License Terms or End-User License Agreement (EULA), Microsoft does not allow redistribution. You may link to the download page, but not directly to the download, from your product or website."
+
+🔗 [https://www.microsoft.com/en-us/legal/intellectualproperty/copyright/permissions](https://www.microsoft.com/en-us/legal/intellectualproperty/copyright/permissions)
diff --git a/docs/faq-and-troubleshooting/common-questions/bluetooth-compatibility.md b/docs/faq-and-troubleshooting/common-questions/bluetooth-compatibility.md
new file mode 100644
index 00000000..ae65156f
--- /dev/null
+++ b/docs/faq-and-troubleshooting/common-questions/bluetooth-compatibility.md
@@ -0,0 +1,23 @@
+---
+description: Does Bluetooth work on AtlasOS?
+icon: material/bluetooth
+---
+
+# Does Bluetooth work on AtlasOS?
+
+**Yes, Bluetooth is fully functional on Atlas, you can choose to enable or disable it during installation.**
+
+If you're using Atlas and not using Automatic Driver Installation, you will need to install the Bluetooth driver yourself.
+
+These steps will guide you on getting setup with Bluetooth:
+
+1. Enable Bluetooth in the Atlas folder
+
+2. Install your Bluetooth driver (from OEM or via our [SDIO guide](../../getting-started/post-installation/drivers/getting-started.md#snappy-driver-installer-origin))
+ - Most issues with Bluetooth are caused by installing improper drivers. Make sure you research and find the driver which is suited for your device.
+
+3. Turn ON Bluetooth, and pair your device
+
+
+
+If this did not work, try researching further into the driver you should download for your system. These are almost always the cause and is not an issue directly with Atlas.
diff --git a/docs/faq-and-troubleshooting/common-questions/decryptying-using-bitlocker.md b/docs/faq-and-troubleshooting/common-questions/decryptying-using-bitlocker.md
new file mode 100644
index 00000000..68d20c65
--- /dev/null
+++ b/docs/faq-and-troubleshooting/common-questions/decryptying-using-bitlocker.md
@@ -0,0 +1,21 @@
+---
+description: A guide on how to decrypt your system drive using BitLocker
+icon: material/lock-check
+---
+
+# Decrypting a BitLocker encrypted drive
+
+BitLocker is pre-installed and configured to encrypt drives on a large number of retail notebooks, particularly Windows 11 laptops.
+
+To run the `setup.exe` file in the `sources` folder, we will be focusing on decrypting the `C:` drive, sometimes known as the "system" drive.
+
+!!! warning "BitLocker data loss"
+ BitLocker is a powerful encryption tool, and using it improperly may result in data loss. It is safe to follow these instructions, but failure to follow steps may result in loss of data.
+
+1. Run `CMD` (Command Prompt) with **Administrator privileges**
+2. Type `manage-bde -off %SystemDrive%` this will then start BitLocker with the parameters we entered
+ - Many users will see: [ERROR: This volume stores external key(s) that can automatically unlock other volumes.](../../assets/images/bitlocker-error-decrypting.jpg). If this applies to you, type `manage-bde -autounlock - ClearAllKeys %SystemDrive%` to clear the keys. After completion, re-type `manage-bde -off %SystemDrive%` to continue decrypting.
+3. If you got "Decryption is now in progress." you have completed the steps correctly. It will take some time to fully decrypt the drive
+4. You can checkthe progress b
+y typing `manage-bde -status` and finding the `C:` drive and the [percentage encrypted](../../assets/images/bitlocker-decryption-progress.png).
+5. When the decyption percentage reaches "0%" you've successfully decrypted the drive!
diff --git a/docs/faq-and-troubleshooting/common-questions/itunes-compatibility.md b/docs/faq-and-troubleshooting/common-questions/itunes-compatibility.md
new file mode 100644
index 00000000..fc3d9585
--- /dev/null
+++ b/docs/faq-and-troubleshooting/common-questions/itunes-compatibility.md
@@ -0,0 +1,20 @@
+---
+description: How to fix Itunes not recognising Apple device?
+icon: material/apple
+---
+
+**iTunes not recognising your Apple device is a driver issue. Diwbkiad Apple USB Drivers to fix this issue.**
+
+If you're using Atlas and not using Automatic Driver Installation, you will need to install the Apple USB driver yourself.
+
+To fix this issue:
+
+1. Download the latest Apple USB drivers from the [Microsoft Update Catalog](https://www.catalog.update.microsoft.com/Search.aspx?q=Apple%2C%20Inc.%20-%20USBDevice)
+
+2. Extract (use 7-Zip or Explorer, ignore any errors/warnings) the zipped driver
+
+3. **Right-click** on the `.inf` file :material-arrow-right: **Install**
+
+Alternatively, use [Microsoft PC Manager](https://pcmanager-en.microsoft.com/) to interact with the core of Windows Update to install the Apple USB drivers, and bypass Atlas' Windows Update driver blocks.
+
+If you're experiencing significant issues with drivers, you can also enable Automatic Driver Installation from the Atlas folder.
diff --git a/docs/faq-and-troubleshooting/common-questions/microsoft-store-compatibility.md b/docs/faq-and-troubleshooting/common-questions/microsoft-store-compatibility.md
new file mode 100644
index 00000000..3139da9c
--- /dev/null
+++ b/docs/faq-and-troubleshooting/common-questions/microsoft-store-compatibility.md
@@ -0,0 +1,14 @@
+---
+description: Does Microsoft Store work on AtlasOS?
+icon: material/microsoft
+---
+
+# Does Microsoft Store work on AtlasOS?
+
+**Yes, Microsoft Store is fully functional in Atlas out of the box.**
+
+Microsoft Store has not been altered in Atlas and works out of the box. If you're having troubles with it, we have some steps you can follow to try and fix any issues.
+
+1. Open CMD (Command Prompt) with Administrator Privileges
+2. Type `wsreset.exe` and pres ++enter++
+3. Try opening Microsoft Store
diff --git a/docs/faq-and-troubleshooting/common-questions/reverting-atlas.md b/docs/faq-and-troubleshooting/common-questions/reverting-atlas.md
new file mode 100644
index 00000000..7da814d5
--- /dev/null
+++ b/docs/faq-and-troubleshooting/common-questions/reverting-atlas.md
@@ -0,0 +1,16 @@
+---
+description: How do I return to Windows after installing AtlasOS?
+icon: material/microsoft-windows
+---
+
+# How do I return to Windows after installing AtlasOS?
+
+**You'll need to reinstall Windows to revert Atlas' modifcation.**
+
+This is required because our installation instructions on our documentation guide you to reinstall Windows (deleting your previous install), then, installing Atlas.
+
+If you need help reinstalling Windows, you can use Google, YouTube or follow our guide on how to install Atlas, but skip out running AME Wizard.
+
+This will get you to a completely stock Windows installation.
+
+🔗 [https://docs.atlasos.net/getting-started/installation/](../../getting-started/installation.md)
diff --git a/docs/faq-and-troubleshooting/removed-features.md b/docs/faq-and-troubleshooting/removed-features.md
new file mode 100644
index 00000000..908b3b01
--- /dev/null
+++ b/docs/faq-and-troubleshooting/removed-features.md
@@ -0,0 +1,30 @@
+---
+description: All Windows features removed by the AtlasOS playbook
+icon: material/file-remove
+---
+
+## :material-delete-off: Features removed from Atlas
+
+Please do keep in mind that Atlas is made for performance and privacy, so many features and services that are not needed have been disabled for these reasons, without any easy way for enabling them. When services or features are taken away, they can cause problems with the apps you use or even with hardware, although generally unlikely. Keep this in mind before installing Atlas.
+
+Atlas gets rid of the following services and features:
+
+- Restore Points and System Reset
+- Telemetry
+- Smart App Control
+- Settings sync
+
+### :material-application: Applications or features uninstalled by default
+
+These can be reinstalled after installation, but are removed by default.
+
+- Many default included Microsoft Store applications
+- Microsoft Update Health Tools
+- Internet Explorer
+- PC Health Check
+- OneDrive
+
+!!! tip
+ If something isn't working, try enabling services or features inside the [Atlas folder on your Desktop](file://C:/Users/default/Desktop/Atlas), and follow our [Configuration guide](../getting-started/post-installation/drivers/getting-started.md) for more info.
+
+ Atlas gives you the option to enable/disable lots of other options too, which you can also find in the folder above.
diff --git a/docs/faq-and-troubleshooting/testing-nightly-builds.md b/docs/faq-and-troubleshooting/testing-nightly-builds.md
new file mode 100644
index 00000000..89fe4b6d
--- /dev/null
+++ b/docs/faq-and-troubleshooting/testing-nightly-builds.md
@@ -0,0 +1,14 @@
+---
+description: How can I test pre-release builds of AtlasOS?
+icon: material/test-tube
+---
+
+# How can I test pre-release builds of AtlasOS?
+
+**If you wish to take part on testing nightly, pre-release dev builds, you can do so by adding the "Development" Discord role to your profile.**
+
+We love it when people want to help contribute to Atlas. If you don't know how to work with AME Wizard, or aren't that technically minded when it comes to registry. This might be something you can help to contribute to.
+
+We often post announcements to the "Development" Discord role when we need help testing new pre-release builds which are close to public releases. If you're interested, you can [join our Discord server](https://discord.atlasos.net/) and apply the "Development" role to your profile.
+
+
diff --git a/docs/faq-and-troubleshooting/updating-atlas.md b/docs/faq-and-troubleshooting/updating-atlas.md
new file mode 100644
index 00000000..adc09dcc
--- /dev/null
+++ b/docs/faq-and-troubleshooting/updating-atlas.md
@@ -0,0 +1,10 @@
+---
+description: How do I update AtlasOS to the latest version?
+icon: material/microsoft-windows
+---
+
+# How do I update AtlasOS to the latest version?
+
+**If you're running a version of Atlas prior to v0.3.0, you can not update.**
+
+We will always recommend users wanting to update to the latest version of Atlas to clean install (to avoid issues). If you're running v0.3.0 and want to update to a newer release, you can "dirty update" if you wish - but it may cause issues.
diff --git a/docs/faq-and-troubleshooting/who-is-atlas-for.md b/docs/faq-and-troubleshooting/who-is-atlas-for.md
new file mode 100644
index 00000000..672d5834
--- /dev/null
+++ b/docs/faq-and-troubleshooting/who-is-atlas-for.md
@@ -0,0 +1,12 @@
+---
+description: Who is AtlasOS designed for?
+icon: material/head-check
+---
+
+# Who is Atlas designed for?
+
+**Atlas is for any enthuisast looking to improve the privacy, performance and ease of use of their Windows installation.**
+
+We're on a mission to make a modification which *mostly* everyone can use, with the least amount of drawbacks.
+
+Although Atlas aims for the best compatibility, performance and quality of life fixes possible, you may have to do some troubleshooting with certain Atlas configurations - which isn't always suitable for everyone.
diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md
index 7c1307fb..c0c6dd01 100644
--- a/docs/getting-started/installation.md
+++ b/docs/getting-started/installation.md
@@ -1,35 +1,29 @@
---
+title: Installation
description: The official AtlasOS playbook installation guide
icon: material/cogs
---
-# Installation
+# :material-package-down: Installing AtlasOS
-!!! danger "Removed Features"
- Before installing, it is highly recommended to take a look at our [Removed Features](/troubleshooting/removed-features/) page.
-
- It is recommended to wait until v0.3.0 releases to install Atlas for improved compatibility, security and many bug fixes.
+!!! danger "Read before continuing"
-!!! info
- Atlas no longer provides ISOs to download, please use this method here to install.
+ AtlasOS is in compliance with the Windows EULA; activation in Windows is not modified.
-## :material-clipboard-list-outline: Requirements
-
-* [AME Wizard](https://atlasos.net/downloads)
-* [Atlas Playbook](https://atlasos.net/downloads)
-* [64-bit](https://support.microsoft.com/en-us/windows/which-version-of-windows-operating-system-am-i-running-628bec99-476a-2c13-5296-9dd081cdd808) CPU (x86/32-bit and ARM isn't supported)
+ It is recommended to take a look at our [FAQ page](../faq-and-troubleshooting/removed-features.md).
-!!! warning "Atlas is not pre-activated"
- Atlas-OS is **NOT** a pre-activated version of Windows. You **must** use a valid key to activate Windows before running. Before buying a Windows 10 (Professional or Home) license, be sure the seller is trustworthy and the key is legitimate — no matter where you buy it.
+## :material-clipboard-list-outline: Requirements
-!!! info "Using a USB stick"
- If you are looking for the other method of installation, see [here](/getting-started/other-installation-methods/usb). However, if you want to install Atlas quickly and easily, we suggest you follow this guide instead.
+- Device which meets [Windows 11](https://www.microsoft.com/en-gb/windows/windows-11-specifications#table1) or [Windows 10](https://www.microsoft.com/en-gb/windows/windows-10-specifications#primaryR2) system requirements *(excluding a Microsoft account and TPM)*
+- [64-bit](https://support.microsoft.com/en-us/windows/which-version-of-windows-operating-system-am-i-running-628bec99-476a-2c13-5296-9dd081cdd808) Intel or AMD CPU
+ - 64-bit ARM (aarch64) isn't supported currently
+- A stable internet connection
## :material-disc: Download an ISO
-An ISO is a virtual disc file, and in this case, it will be the Windows Setup. This is required to reinstall Windows in our recommended way.
+An ISO is a virtual disc file (like a DVD) that we will use to reinstall Windows in our recommended way.
-The downloader integrated into the documentation generates an ISO download link from Microsoft. It will download the latest version of Windows 10 for Intel and AMD CPUs.
+The downloader integrated into the documentation below generates an ISO download link from Microsoft. It will download the latest version of Windows for Intel and AMD CPUs.
**Based upon:** [Microsoft Software Download Listing](https://github.com/massgravel/msdl)
@@ -37,14 +31,14 @@ The downloader integrated into the documentation generates an ISO download link
=== "Windows Media Creation Tool"
This is the supported method to download Windows 10 and 11 by Microsoft.
- 1. Download the [Windows 10](https://go.microsoft.com/fwlink/?LinkId=691209) Media Creation Tool and open it.
+ 1. Download the [Windows 10](https://go.microsoft.com/fwlink/?LinkId=691209) or [Windows 11](https://go.microsoft.com/fwlink/?linkid=2156295) Media Creation Tool and open it.
2. Click the `Accept` button to agree to the Microsoft license terms.
3. Tick `Create installation media (USB flash drive, DVD, or ISO file) for another PC`, click `Next`, and choose:
* Language: Desired language
- * Edition: Windows 10
+ * Edition: Windows 10 or 11
* Architecture: 64-bit (x64)
4. Choose `ISO file` option and choose the download location.
- 5. After the ISO completed downloading, click `Finish` to end the installation.
+ 5. After the ISO has completed downloading, click `Finish` to end the installation.
-
+
@@ -68,7 +62,7 @@ The downloader integrated into the documentation generates an ISO download link
An error has occurred while processing your request.
-
Try refreshing the page, or using an alternative method.
+
Try refreshing the page or using an alternative method.
@@ -78,91 +72,138 @@ The downloader integrated into the documentation generates an ISO download link
-## :material-download: Preparing Atlas
+## :material-download: Preparation
-!!! tip "Download drivers"
- Some network adapters do not have drivers that come with Windows. This means that on some computers, you might not be able to connect to the internet after installing. We recommend you to download the drivers for your network adapter ahead of time, and put them on your external drive.
+For the following steps in our documentation, we assume you have another drive to store Atlas' installation files during reinstallation. If you only have one drive, follow the steps in **"Only have one drive to store files?"** below this message, to create a new volume from your single drive.
-Once you have all of the downloads for Atlas from [here](/getting-started/installation/#requirements), you will need to have them on your new installation of Windows for use offline.
+??? question "Only have one drive to store files?"
-You can do this by either using an external drive like a USB stick or a seperate hard drive in your computer, which won't be wiped/formatted. Alternatively, see [here](/getting-started/installation/#creating-a-temporary-partition) if you don't have anything to put files on.
+ !!! tip
+ If you run into any issues with Disk Management, you can alternatively use [Macroit Partition Expert Free Edition](https://macrorit.com/partition-magic-manager/free-edition.html).
-1. Extract `Atlas [version].zip` onto the root directory of your seperate drive, and rename the folder it extracts to `Atlas`
-2. Extract `AME Wizard.exe` from the `AME Wizard Beta.zip`, then place it in your newly created `Atlas` folder
+ 1. Open Disk Management (`diskmgmt.msc`) and locate your Windows drive
+ 2. Right-click :material-arrow-right: Shrink volume
+ 3. Type `4000` in the amount of space to shrink (in megabytes), which is 4GB
+ 4. There should now be 'Unallocated' space, right-click :material-arrow-right: 'New Simple Volume'
+ 5. Go through the wizard, you can keep clicking 'Next'
-You should now have an Atlas folder with all the files you need on the root directory of your external drive.
+ After following these steps, you should have a new storage device in your File Explorer. You can now continue with the rest
-### :material-harddisk-plus: Creating a temporary partition
+
:material-harddisk-remove: Deleting the temporary partition later
-!!! info
- This is only for the case that you have **nothing** to put the Atlas files on, which won't be wiped by reinstalling Windows.
-
- If you have already done the [Preparing Atlas](/getting-started/installation/#preparing-atlas) steps, skip to [Reinstalling Windows](/getting-started/installation/#reinstalling-windows).
-
-!!! tip
- If you run into any issues with Disk Management, you can alternatively use [Macroit Partition Expert Free Edition](https://macrorit.com/partition-magic-manager/free-edition.html).
+ 1. Right-click :material-arrow-right: Delete volume
+ 2. Right-click on your Windows drive :material-arrow-right: Extend volume
+ 3. Go through the wizard, you can keep clicking 'Next'
-1. Open Disk Management (`diskmgmt.msc`) and locate your `C:` drive
-2. Right click :material-arrow-right: Shrink volume
-3. Type `4000` in the amount of space to shrink (in megabytes), which is 4GB
-4. There should now be 'Unallocated' space, right click :material-arrow-right: New Simple Volume
-5. Go through the wizard, you can simply keep clicking 'Next'
+Firstly, let's create a folder to contain the installation files for Atlas. Create a folder on your second drive/volume called `AtlasFiles`. We will refer to this as "your folder" in the following steps.
-#### :material-harddisk-remove: Deleting the temporary partition later
+1. Head over to the [Atlas downloads](https://atlasos.net/) and download **AME Wizard** and the **Atlas Playbook**
+2. Download network drivers from your device/motherboard manufacturer's website into your folder *(in case networking doesn't work on installation, we can use this)*
+ - We recommend searching for the brand (e.g. Dell) followed by your device model number
+ - If you're having trouble, search for your device in [Device Manager](../assets/images/device-manager-nic.png) and download this driver using the internet from the original source
+3. Extract `Atlas [version].zip` into your folder
+4. Extract `AME Wizard Beta.exe` from the downloaded `AME Wizard Beta.zip` into your folder
-1. Right click :material-arrow-right: Delete volume
-2. Right click on your `C:` drive :material-arrow-right: Extend volume
-3. Go through the wizard, you can simply keep clicking 'Next'
+**You should now have an `AtlasFiles` folder with all the files you need on your external drive/volume.**
## :material-microsoft-windows: Reinstalling Windows
-Before proceeding, it is recommended to do backups of files that you may need. Although your old installation (including user data) will be placed a `Windows.old` folder in your `C:` drive in your new installation, there will always be a small risk of something going wrong.
+!!! info "USB Installation"
+ If you want to install with a USB stick instead, you can do that and skip this section. **Make sure that your `AtlasFiles` folder doesn't get deleted.**
+
+!!! tip "Bypassing Windows 11 Requirements (optional)"
+ You can bypass Windows 11 requirements by using the `Bypass Windows 11 Requirements.cmd` script in your folder before launching `sources\setup.exe`.
+
+Before proceeding, back up any necessary files to a second drive or cloud platform.
+
+However, your old installation (including user data) will be copied to a `Windows.old` folder in your Windows drive. Use this as a safety measure if you forget to back up important files.
+
+1. Right-click the ISO file we downloaded previously, clicking **Open With** :material-arrow-right: **File Explorer**. This will mount it to your File Explorer
+
+2. Under **This PC**, there should be an option for this ISO. Open it, then proceed to the `sources` folder, and open `setup.exe`
+ - For many retail Windows 11 laptops, BitLocker comes pre-installed, encrypting all drives on the machine. The message ["Make sure BitLocker Drive Encryption is suspended"](../assets/images/bitlocker-error-setup.jpg) will appear when you attempt to execute the `setup.exe`. Refer to our [BitLocker decrypting instructions](../faq-and-troubleshooting/common-questions/decryptying-using-bitlocker.md) to resolve this.
-You will want to do this offline to ensure that no drivers can install via Windows Update in your new installation, so that the minimal third-party drivers are installed for the lightest experience.
+3. Click **No thanks** to the updates, and uncheck **I want to help make the Windows installation better**
-!!! tip "Dual booting"
- Although not covered here, you can also dual boot Windows with this method. You would have to make a seperate partition to dual boot with, then select that instead of `C:` in the Windows Setup.
+4. Click **I don't have a product key**, as Windows will activate automatically later (if you're currently activated)
-1. Double click your downloaded ISO to mount it, which adds the ISO as a virtual read-only drive in File Explorer. If it opens up in a program like WinRAR or 7-Zip, right click the ISO, click 'Open With' then open it with File Explorer.
+5. Select your edition of Windows. We highly recommend and only officially support **Windows Pro**, but if you do not have a license for it, use **Windows Home** *(not recommended)*
-2. Go to your mounted ISO (as a drive letter) in File Explorer, then go into `sources`, and open `setup.exe`.
+6. Accept the license agreement and click **Custom: Install Windows only (advanced)**
-3. Click 'No thanks' to the updates, as you will update Windows once you have finished reinstalling, and uncheck 'I want to help make the Windows installation better' for privacy reasons.
+7. Select your Windows drive, click next, click **OK** to the warning about `Windows.old`, and let the installation finish
-4. Click 'I don't have a product key', as Windows will activate its self (if you are currently activated) once you have finished installing.
+### :material-cog: Initial setup (OOBE)
-5. Select your edition of Windows, we highly recommend Windows 10 Pro, but if you do not have a key for it, use Windows 10 Home.
+!!! danger "Internet connection"
-6. Accept the license agreement, click 'Custom: Install Windows only (advanced)' to completely wipe your current installation of Windows and replace it with the new one.
+ Inside of the Windows Setup, you should have **your ethernet cable and Wi-Fi disconnected**, and you should not reconnect it until further instruction.
-7. Find your `C:` drive, click next, click 'OK' to the warning about `Windows.old`, and let the installation do its thing (you might restart a couple of times) and wait.
+=== "Windows 11"
+ ??? info "Written Instructions"
+ 1. Once in the setup, press ++shift+f10++ to open Command Prompt
+ 2. Type in `oobe\bypassnro` and press ++enter++. Your computer will restart.
+ 3. Continue through with setup as normal, but make sure to:
+ - Not connect to the internet
+ - Deny each privacy option
-8. Finish installing Windows and in the OOBE, follow the video attached:
+
Credit to [@amitxv](https://github.com/amitxv) for the video demonstration.
+
+
+## :material-screwdriver: Driver Updates
+
+Drivers are essential software components that allow the OS to communicate with hardware devices. While Windows has basic drivers pre-installed, some devices need additional drivers to function. Examples of devices would be bluetooth, printers or speakers.
+
+Automatic driver installation simplifies the process and keeps drivers up-to-date, saving time and effort with the downside of more bloat.
+
+Before continuing, consider which option is right for you and keep it in mind for future steps.
+
+| :material-download: Manual Driver Installation & Updates (recommended) | :material-update: Automatic Driver Installation & Updates |
+| ------------------------------------ | --------------------------------------- |
+| :material-check-all: Potentially less system resource usage | :material-check-all: Easiest if you don't know how to get drivers |
+| :material-check-all: Less potential bloat/annoyances | :material-check: Best compatibility, especially with OEM apps |
+| :material-check: Full control over your driver versions | :material-check: Convienient with new getting devices |
+| :material-alert-circle-outline: Ability to switch to automatic driver updates later | :material-check: Latest security and feature updates |
+
+## :material-wrench-cog-outline: Installing AtlasOS
+
+!!! tip
+ Your old Windows installation will be put into a `Windows.old` folder in your Windows drive on your new installation. You can copy the files that you may need before deleting it
-9. Once inside Windows, your old Windows installation will be put into a `Windows.old` folder in your `C:` drive on your new installation. You can copy the files that you need from it before deleting it.
+ To delete your previous Windows installation, go to Windows Settings :material-arrow-right: System :material-arrow-right: Storage, then click 'Temporary files', select 'Previous version of Windows' and then click 'Remove files'
-10. To delete your previous Windows installation, goto Settings :material-arrow-right: System :material-arrow-right: Storage, then click 'Temporary files', select 'Previous version of Windows' and then click 'Remove files'.
+We previously mentioned in the [Driver Updates](#driver-updates) section regarding two options: Manual and Automatic Driver Installation. You'll need to choose one before continuing.
-## :material-wrench-cog-outline: Install Atlas
+1. Copy the `AtlasFiles` from your seperate drive/volume to your desktop
+2. If you have chosen **Manual Driver Installation**, run `Disable Drivers Installation in Windows Update.reg` and restart
+3. Connect to the internet
+ - If you can't connect to the internet, [install the network adapter driver](https://www.techspot.com/community/topics/how-to-install-a-driver-when-theres-no-installation-exe-file-to-run.171861/) you downloaded prior to reinstalling located in `AtlasFiles`
+4. Go to **Windows Settings** and update Windows until there's no more updates left. Additionally, go to the **Microsoft Store** and update all the apps there
+ - You will need to restart after completing updates. After restarting, check again for updates repeatedly until there are no more updates that pop-up
+5. Open `AtlasFiles` and proceed to running `AME Wizard Beta.exe`
+ - SmartScreen will notify you that AME Wizard is an unrecognized application, as it is not digitally signed. You can get around this by pressing **More info** and **Run anyway**
+6. Drag and drop the `Atlas Playbook.apbx` into AME Wizard from the `AtlasFiles` folder
+7. Follow the on-screen instructions to successfully install AtlasOS
-1. Place the `Atlas` folder from your external drive (like a USB). If you previously made a temporary partition, you can delete it [here](/getting-started/installation/#creating-a-temporary-partition).
-2. Run `Disable Drivers Installation in Windows Update.reg` to prevent Windows from automatically installing drivers via Windows Update, and restart your computer.
-3. After restarting, you can install ethernet drivers, and connect to the internet.
-4. Make sure you have the latest updates by running Windows Update. Once you are done, restart your computer and look for any updates you may have missed.
-5. You will need to disable `Memory Integrity` due to current incompatibilities with AME Wizard, which you can do by opening `Windows Security`, then click `Device Security` on the left. From here, click `Core isolation details` and then turn off `Memory Integrity`.
-6. Run `AME Wizard.exe` and load the Atlas Playbook, and follow the wizard instructions.
- - SmartScreen will notify you that the wizard is unsigned. You can get around this by pressing `More info` and `Run anyway`.
- - You may have to activate Windows to install Atlas. Get a supported key for Home/Pro, depending on what you installed and activate in Windows Settings.
-7. After Atlas has fully installed, run the `Fix-Auto-Cleaner.bat` script in the `Atlas` folder.
- - This will fix various issues with v0.2, which will be fixed in v0.3.0. See the ['Auto Cleaner issues'](https://docs.atlasos.net/troubleshooting/common-issues/auto-cleaner/) page for more information.
+!!! danger "AME Wizard closing and being deleted?"
+ To prevent Windows Defender from closing and deleting the AME Wizard file, you should add AME Wizard to the exclusion list in the Windows Security settings. This is usually necessary when a new version of AME Wizard is released, which has not been used by many people yet.
-Once completed, your system will be optimized and have less junk on it, thanks to Atlas, you will enjoy more privacy, and better performance.
+ To read more about this, view the [Security Exceptions](https://docs.ameliorated.io/guides/security-exceptions.html) docs from the Ameliorated team.
-!!! info ""
- After completing the Atlas installation process, continue the [Post-Installation](/getting-started/post-installation/drivers/) section in our documentation, and then continue to the other sections.
+Once completed, you will see the `Atlas` folder on your desktop. We guide you on how to configure your Atlas installation using this folder at the [Post Installation](post-installation/drivers/getting-started.md) part of the documentation.
### :material-bug-outline: Troubleshooting
!!! tip "Need help?"
- If you face any trouble while installing, you can ask for help on our [forums](https://forum.atlasos.net), or our [Discord server](https://discord.atlasos.net). We have a big community of people who care and want to help.
+ If you face any trouble while installing, you can ask for help on our [Forums](https://forum.atlasos.net), or our [Discord server](https://discord.atlasos.net). We have a large community of people who care and want to help.
-Please see our [troubleshooting section](/troubleshooting/removed-features/) for issues like being stuck on 'Reticulating Splines'.
+ We recommend viewing our [FAQ](../faq-and-troubleshooting/removed-features.md) before posting in our Discord server or Forum to reduce wait time for possible common, answered questions.
diff --git a/docs/getting-started/other-installation-methods/usb.md b/docs/getting-started/other-installation-methods/usb.md
deleted file mode 100644
index 415e0f3a..00000000
--- a/docs/getting-started/other-installation-methods/usb.md
+++ /dev/null
@@ -1,96 +0,0 @@
----
-description: The official USB AtlasOS playbook installation guide
-icon: material/usb-port
----
-
-# USB Installation Guide
-
-## :material-clipboard-list-outline: Additional requirements
-
-You should also meet the regular [Requirements](/getting-started/installation/#requirements).
-
-* A USB drive (8 GB minimum)
-* Bootable USB creator
-* A backup of all the files that you want to keep, either in the cloud or on an external drive
-
-## :material-chip: Identify boot mode
-
-To identify your boot mode, you can look it up in your BIOS or check it in Windows.
-To check it in Windows, you can use PowerShell, and copy and paste the following (make sure you run PowerShell as an administrator):
-
-```PowerShell
-fltmc >$null;if($LASTEXITCODE -ne 0){echo "Not running as admin!"}else{$BootMode = If(bcdedit | Select-String "path.*efi"){"UEFI"}else{"legacy"};echo "Computer is running in $BootMode boot mode."}
-```
-
-You will either get `UEFI` or `Legacy`. `UEFI` is a newer BIOS mode that is recommended for new machines, and it supports the `GPT` partition style. `Legacy` is an older BIOS mode, and it supports the `MBR` partition style.
-
-!!! info ""
- It is not recommended to run UEFI with MBR or BIOS with GPT as it may cause compatibility and stability issues.
- If you are using a mixed combination, you may want to [convert your partition style](https://learn.microsoft.com/en-us/windows-server/storage/disk-management/change-an-mbr-disk-into-a-gpt-disk) during the installation.
-
- **Here's how to check with Disk Management:**
-
-
diff --git a/docs/faq-and-troubleshooting/common-questions/atlas-iso-files.md b/docs/faq-and-troubleshooting/common-questions/atlas-iso-files.md
new file mode 100644
index 00000000..402871ae
--- /dev/null
+++ b/docs/faq-and-troubleshooting/common-questions/atlas-iso-files.md
@@ -0,0 +1,14 @@
+---
+description: Where can I find the Atlas ISO file?
+icon: material/disc
+---
+
+# Where is the Atlas ISO file?
+
+**Atlas doesn't have an ISO file. It uses AME Wizard to modify Windows on a new live installation, applying configurations like an ISO file.**
+
+Distributing ISO files violates Microsoft's EULA and poses safety risks due to uncertainty about the contents. We use AME Wizard and use releases directly from our GitHub. We also include a checksum in case you wish to verify the integrity of your download.
+
+> "For software downloads, unless expressly permitted in the accompanying License Terms or End-User License Agreement (EULA), Microsoft does not allow redistribution. You may link to the download page, but not directly to the download, from your product or website."
+
+🔗 [https://www.microsoft.com/en-us/legal/intellectualproperty/copyright/permissions](https://www.microsoft.com/en-us/legal/intellectualproperty/copyright/permissions)
diff --git a/docs/faq-and-troubleshooting/common-questions/bluetooth-compatibility.md b/docs/faq-and-troubleshooting/common-questions/bluetooth-compatibility.md
new file mode 100644
index 00000000..ae65156f
--- /dev/null
+++ b/docs/faq-and-troubleshooting/common-questions/bluetooth-compatibility.md
@@ -0,0 +1,23 @@
+---
+description: Does Bluetooth work on AtlasOS?
+icon: material/bluetooth
+---
+
+# Does Bluetooth work on AtlasOS?
+
+**Yes, Bluetooth is fully functional on Atlas, you can choose to enable or disable it during installation.**
+
+If you're using Atlas and not using Automatic Driver Installation, you will need to install the Bluetooth driver yourself.
+
+These steps will guide you on getting setup with Bluetooth:
+
+1. Enable Bluetooth in the Atlas folder
+
+2. Install your Bluetooth driver (from OEM or via our [SDIO guide](../../getting-started/post-installation/drivers/getting-started.md#snappy-driver-installer-origin))
+ - Most issues with Bluetooth are caused by installing improper drivers. Make sure you research and find the driver which is suited for your device.
+
+3. Turn ON Bluetooth, and pair your device
+
+
+
+If this did not work, try researching further into the driver you should download for your system. These are almost always the cause and is not an issue directly with Atlas.
diff --git a/docs/faq-and-troubleshooting/common-questions/decryptying-using-bitlocker.md b/docs/faq-and-troubleshooting/common-questions/decryptying-using-bitlocker.md
new file mode 100644
index 00000000..68d20c65
--- /dev/null
+++ b/docs/faq-and-troubleshooting/common-questions/decryptying-using-bitlocker.md
@@ -0,0 +1,21 @@
+---
+description: A guide on how to decrypt your system drive using BitLocker
+icon: material/lock-check
+---
+
+# Decrypting a BitLocker encrypted drive
+
+BitLocker is pre-installed and configured to encrypt drives on a large number of retail notebooks, particularly Windows 11 laptops.
+
+To run the `setup.exe` file in the `sources` folder, we will be focusing on decrypting the `C:` drive, sometimes known as the "system" drive.
+
+!!! warning "BitLocker data loss"
+ BitLocker is a powerful encryption tool, and using it improperly may result in data loss. It is safe to follow these instructions, but failure to follow steps may result in loss of data.
+
+1. Run `CMD` (Command Prompt) with **Administrator privileges**
+2. Type `manage-bde -off %SystemDrive%` this will then start BitLocker with the parameters we entered
+ - Many users will see: [ERROR: This volume stores external key(s) that can automatically unlock other volumes.](../../assets/images/bitlocker-error-decrypting.jpg). If this applies to you, type `manage-bde -autounlock - ClearAllKeys %SystemDrive%` to clear the keys. After completion, re-type `manage-bde -off %SystemDrive%` to continue decrypting.
+3. If you got "Decryption is now in progress." you have completed the steps correctly. It will take some time to fully decrypt the drive
+4. You can checkthe progress b
+y typing `manage-bde -status` and finding the `C:` drive and the [percentage encrypted](../../assets/images/bitlocker-decryption-progress.png).
+5. When the decyption percentage reaches "0%" you've successfully decrypted the drive!
diff --git a/docs/faq-and-troubleshooting/common-questions/itunes-compatibility.md b/docs/faq-and-troubleshooting/common-questions/itunes-compatibility.md
new file mode 100644
index 00000000..fc3d9585
--- /dev/null
+++ b/docs/faq-and-troubleshooting/common-questions/itunes-compatibility.md
@@ -0,0 +1,20 @@
+---
+description: How to fix Itunes not recognising Apple device?
+icon: material/apple
+---
+
+**iTunes not recognising your Apple device is a driver issue. Diwbkiad Apple USB Drivers to fix this issue.**
+
+If you're using Atlas and not using Automatic Driver Installation, you will need to install the Apple USB driver yourself.
+
+To fix this issue:
+
+1. Download the latest Apple USB drivers from the [Microsoft Update Catalog](https://www.catalog.update.microsoft.com/Search.aspx?q=Apple%2C%20Inc.%20-%20USBDevice)
+
+2. Extract (use 7-Zip or Explorer, ignore any errors/warnings) the zipped driver
+
+3. **Right-click** on the `.inf` file :material-arrow-right: **Install**
+
+Alternatively, use [Microsoft PC Manager](https://pcmanager-en.microsoft.com/) to interact with the core of Windows Update to install the Apple USB drivers, and bypass Atlas' Windows Update driver blocks.
+
+If you're experiencing significant issues with drivers, you can also enable Automatic Driver Installation from the Atlas folder.
diff --git a/docs/faq-and-troubleshooting/common-questions/microsoft-store-compatibility.md b/docs/faq-and-troubleshooting/common-questions/microsoft-store-compatibility.md
new file mode 100644
index 00000000..3139da9c
--- /dev/null
+++ b/docs/faq-and-troubleshooting/common-questions/microsoft-store-compatibility.md
@@ -0,0 +1,14 @@
+---
+description: Does Microsoft Store work on AtlasOS?
+icon: material/microsoft
+---
+
+# Does Microsoft Store work on AtlasOS?
+
+**Yes, Microsoft Store is fully functional in Atlas out of the box.**
+
+Microsoft Store has not been altered in Atlas and works out of the box. If you're having troubles with it, we have some steps you can follow to try and fix any issues.
+
+1. Open CMD (Command Prompt) with Administrator Privileges
+2. Type `wsreset.exe` and pres ++enter++
+3. Try opening Microsoft Store
diff --git a/docs/faq-and-troubleshooting/common-questions/reverting-atlas.md b/docs/faq-and-troubleshooting/common-questions/reverting-atlas.md
new file mode 100644
index 00000000..7da814d5
--- /dev/null
+++ b/docs/faq-and-troubleshooting/common-questions/reverting-atlas.md
@@ -0,0 +1,16 @@
+---
+description: How do I return to Windows after installing AtlasOS?
+icon: material/microsoft-windows
+---
+
+# How do I return to Windows after installing AtlasOS?
+
+**You'll need to reinstall Windows to revert Atlas' modifcation.**
+
+This is required because our installation instructions on our documentation guide you to reinstall Windows (deleting your previous install), then, installing Atlas.
+
+If you need help reinstalling Windows, you can use Google, YouTube or follow our guide on how to install Atlas, but skip out running AME Wizard.
+
+This will get you to a completely stock Windows installation.
+
+🔗 [https://docs.atlasos.net/getting-started/installation/](../../getting-started/installation.md)
diff --git a/docs/faq-and-troubleshooting/removed-features.md b/docs/faq-and-troubleshooting/removed-features.md
new file mode 100644
index 00000000..908b3b01
--- /dev/null
+++ b/docs/faq-and-troubleshooting/removed-features.md
@@ -0,0 +1,30 @@
+---
+description: All Windows features removed by the AtlasOS playbook
+icon: material/file-remove
+---
+
+## :material-delete-off: Features removed from Atlas
+
+Please do keep in mind that Atlas is made for performance and privacy, so many features and services that are not needed have been disabled for these reasons, without any easy way for enabling them. When services or features are taken away, they can cause problems with the apps you use or even with hardware, although generally unlikely. Keep this in mind before installing Atlas.
+
+Atlas gets rid of the following services and features:
+
+- Restore Points and System Reset
+- Telemetry
+- Smart App Control
+- Settings sync
+
+### :material-application: Applications or features uninstalled by default
+
+These can be reinstalled after installation, but are removed by default.
+
+- Many default included Microsoft Store applications
+- Microsoft Update Health Tools
+- Internet Explorer
+- PC Health Check
+- OneDrive
+
+!!! tip
+ If something isn't working, try enabling services or features inside the [Atlas folder on your Desktop](file://C:/Users/default/Desktop/Atlas), and follow our [Configuration guide](../getting-started/post-installation/drivers/getting-started.md) for more info.
+
+ Atlas gives you the option to enable/disable lots of other options too, which you can also find in the folder above.
diff --git a/docs/faq-and-troubleshooting/testing-nightly-builds.md b/docs/faq-and-troubleshooting/testing-nightly-builds.md
new file mode 100644
index 00000000..89fe4b6d
--- /dev/null
+++ b/docs/faq-and-troubleshooting/testing-nightly-builds.md
@@ -0,0 +1,14 @@
+---
+description: How can I test pre-release builds of AtlasOS?
+icon: material/test-tube
+---
+
+# How can I test pre-release builds of AtlasOS?
+
+**If you wish to take part on testing nightly, pre-release dev builds, you can do so by adding the "Development" Discord role to your profile.**
+
+We love it when people want to help contribute to Atlas. If you don't know how to work with AME Wizard, or aren't that technically minded when it comes to registry. This might be something you can help to contribute to.
+
+We often post announcements to the "Development" Discord role when we need help testing new pre-release builds which are close to public releases. If you're interested, you can [join our Discord server](https://discord.atlasos.net/) and apply the "Development" role to your profile.
+
+
diff --git a/docs/faq-and-troubleshooting/updating-atlas.md b/docs/faq-and-troubleshooting/updating-atlas.md
new file mode 100644
index 00000000..adc09dcc
--- /dev/null
+++ b/docs/faq-and-troubleshooting/updating-atlas.md
@@ -0,0 +1,10 @@
+---
+description: How do I update AtlasOS to the latest version?
+icon: material/microsoft-windows
+---
+
+# How do I update AtlasOS to the latest version?
+
+**If you're running a version of Atlas prior to v0.3.0, you can not update.**
+
+We will always recommend users wanting to update to the latest version of Atlas to clean install (to avoid issues). If you're running v0.3.0 and want to update to a newer release, you can "dirty update" if you wish - but it may cause issues.
diff --git a/docs/faq-and-troubleshooting/who-is-atlas-for.md b/docs/faq-and-troubleshooting/who-is-atlas-for.md
new file mode 100644
index 00000000..672d5834
--- /dev/null
+++ b/docs/faq-and-troubleshooting/who-is-atlas-for.md
@@ -0,0 +1,12 @@
+---
+description: Who is AtlasOS designed for?
+icon: material/head-check
+---
+
+# Who is Atlas designed for?
+
+**Atlas is for any enthuisast looking to improve the privacy, performance and ease of use of their Windows installation.**
+
+We're on a mission to make a modification which *mostly* everyone can use, with the least amount of drawbacks.
+
+Although Atlas aims for the best compatibility, performance and quality of life fixes possible, you may have to do some troubleshooting with certain Atlas configurations - which isn't always suitable for everyone.
diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md
index 7c1307fb..c0c6dd01 100644
--- a/docs/getting-started/installation.md
+++ b/docs/getting-started/installation.md
@@ -1,35 +1,29 @@
---
+title: Installation
description: The official AtlasOS playbook installation guide
icon: material/cogs
---
-# Installation
+# :material-package-down: Installing AtlasOS
-!!! danger "Removed Features"
- Before installing, it is highly recommended to take a look at our [Removed Features](/troubleshooting/removed-features/) page.
-
- It is recommended to wait until v0.3.0 releases to install Atlas for improved compatibility, security and many bug fixes.
+!!! danger "Read before continuing"
-!!! info
- Atlas no longer provides ISOs to download, please use this method here to install.
+ AtlasOS is in compliance with the Windows EULA; activation in Windows is not modified.
-## :material-clipboard-list-outline: Requirements
-
-* [AME Wizard](https://atlasos.net/downloads)
-* [Atlas Playbook](https://atlasos.net/downloads)
-* [64-bit](https://support.microsoft.com/en-us/windows/which-version-of-windows-operating-system-am-i-running-628bec99-476a-2c13-5296-9dd081cdd808) CPU (x86/32-bit and ARM isn't supported)
+ It is recommended to take a look at our [FAQ page](../faq-and-troubleshooting/removed-features.md).
-!!! warning "Atlas is not pre-activated"
- Atlas-OS is **NOT** a pre-activated version of Windows. You **must** use a valid key to activate Windows before running. Before buying a Windows 10 (Professional or Home) license, be sure the seller is trustworthy and the key is legitimate — no matter where you buy it.
+## :material-clipboard-list-outline: Requirements
-!!! info "Using a USB stick"
- If you are looking for the other method of installation, see [here](/getting-started/other-installation-methods/usb). However, if you want to install Atlas quickly and easily, we suggest you follow this guide instead.
+- Device which meets [Windows 11](https://www.microsoft.com/en-gb/windows/windows-11-specifications#table1) or [Windows 10](https://www.microsoft.com/en-gb/windows/windows-10-specifications#primaryR2) system requirements *(excluding a Microsoft account and TPM)*
+- [64-bit](https://support.microsoft.com/en-us/windows/which-version-of-windows-operating-system-am-i-running-628bec99-476a-2c13-5296-9dd081cdd808) Intel or AMD CPU
+ - 64-bit ARM (aarch64) isn't supported currently
+- A stable internet connection
## :material-disc: Download an ISO
-An ISO is a virtual disc file, and in this case, it will be the Windows Setup. This is required to reinstall Windows in our recommended way.
+An ISO is a virtual disc file (like a DVD) that we will use to reinstall Windows in our recommended way.
-The downloader integrated into the documentation generates an ISO download link from Microsoft. It will download the latest version of Windows 10 for Intel and AMD CPUs.
+The downloader integrated into the documentation below generates an ISO download link from Microsoft. It will download the latest version of Windows for Intel and AMD CPUs.
**Based upon:** [Microsoft Software Download Listing](https://github.com/massgravel/msdl)
@@ -37,14 +31,14 @@ The downloader integrated into the documentation generates an ISO download link
=== "Windows Media Creation Tool"
This is the supported method to download Windows 10 and 11 by Microsoft.
- 1. Download the [Windows 10](https://go.microsoft.com/fwlink/?LinkId=691209) Media Creation Tool and open it.
+ 1. Download the [Windows 10](https://go.microsoft.com/fwlink/?LinkId=691209) or [Windows 11](https://go.microsoft.com/fwlink/?linkid=2156295) Media Creation Tool and open it.
2. Click the `Accept` button to agree to the Microsoft license terms.
3. Tick `Create installation media (USB flash drive, DVD, or ISO file) for another PC`, click `Next`, and choose:
* Language: Desired language
- * Edition: Windows 10
+ * Edition: Windows 10 or 11
* Architecture: 64-bit (x64)
4. Choose `ISO file` option and choose the download location.
- 5. After the ISO completed downloading, click `Finish` to end the installation.
+ 5. After the ISO has completed downloading, click `Finish` to end the installation.