From 948febcfe0981f3581012df3a7ce135a95669499 Mon Sep 17 00:00:00 2001 From: ArchDevs Date: Fri, 11 Jul 2025 22:35:14 +0400 Subject: [PATCH 1/4] added: dual boot guide --- src/content/docs/guides/dual-boot.md | 244 +++++++++++++++++++++++++++ 1 file changed, 244 insertions(+) create mode 100644 src/content/docs/guides/dual-boot.md diff --git a/src/content/docs/guides/dual-boot.md b/src/content/docs/guides/dual-boot.md new file mode 100644 index 0000000..9263c52 --- /dev/null +++ b/src/content/docs/guides/dual-boot.md @@ -0,0 +1,244 @@ +# Dual Boot Guide: Windows + AxOS + +How to do a full **dual boot installation** with **Windows 11** and **AxOS** (Windows 10 should work as well). + +> **System Requirements**: [Check here](https://www.axos-project.com/docs/get-started/installation/#required) +> Minimum disk space: **10 GB** (but **50 GB or more is strongly recommended** for a smoother experience) + +## Step 0: Before You Begin + +> I will **skip the steps** for flashing AxOS to a USB. Please make sure you’ve already created a **bootable USB**. + + +## Step 1: Create Free Space on Your Disk (Windows) + +We need to shrink an existing partition to make room for AxOS. + +> ⚠️ **Important Note**: +> It’s strongly recommended to install Linux on the **same physical disk (SSD/HDD)** where Windows is installed. Installing it on a second disk can cause bootloader issues or system instability. + +### Instructions: + +1. Press `Win + X` → choose **Disk Management** + *or* + Press `Win + R`, type `diskmgmt.msc`, and hit Enter. +2. In the Disk Management window: + + * Right-click on a partition with enough free space (e.g. your D: drive) + * Click **"Shrink Volume"** + * Enter how much you want to shrink (in MB). For example, `50000` for 50 GB + * Click **"Shrink"** + +This will create **unallocated space** which we’ll use to install AxOS. + + +## Step 2: Boot into AxOS from USB + +1. Reboot your computer +2. Enter your **BIOS/UEFI menu** +3. Select your **bootable USB** device +4. Boot to AxOS + + +## Step 3: Verify Free Space in AxOS + +Once inside the live AxOS, open the terminal (`Win + Enter`) and run: + +```bash +sudo parted -l +``` + +This will list all available disks and their partitions. + +Look for something like: + +``` +Unallocated space: 50GB +``` + +Or run: + +```bash +sudo parted -l | grep "Unallocated" +``` + +> **Note:** Take note of your disk’s name — it could be something like: +> +> * `/dev/sda` +> * `/dev/nvme0n1` +> +> We’ll use that name in the next step. + + +## Step 4: Create Partitions with `gdisk` + +We’ll now use `gdisk` to manually create two partitions: + +* One for the **EFI System** (`/boot/efi`) +* One for the **Linux Root** (`/`) + +Replace `yourdiskname` below with your actual disk name (e.g. `/dev/sda` or `/dev/nvme0n1`). + +```bash +sudo gdisk /dev/yourdiskname +``` + +### Inside `gdisk`: + +1. Press `n` to create a **new partition** +2. Press `Enter` to accept default partition number +3. Press `Enter` to accept default first sector +4. Type `+512M` → this creates a 512MB partition +5. Type `EF00` → this sets it as an **EFI System** partition + +EFI partition done! + + +### Create the Root Partition (`/`): + +1. Press `n` again +2. Press `Enter` for all prompts (partition number, first/last sector, partition type) +3. Type `w` and press `Enter` to **write changes** + +> Confirm with `y` if asked. + +We’ve now created two partitions, but they are still **unformatted**. + + +## Step 5: Format the Partitions + +We now format the two partitions to make them usable by the system. + +> ⚠️ The **partition names** depend on your disk: +> +> * If your disk is `/dev/sda`, partitions will be `/dev/sda1`, `/dev/sda2`, etc. +> * If your disk is `/dev/nvme0n1`, partitions will be `/dev/nvme0n1p1`, `/dev/nvme0n1p2`, etc. +> *(Note the **"p"** before the number of partition)* + +### Format the EFI Partition: + +```bash +sudo mkfs.fat -F32 /dev/nvme0n1p1 +``` + +### Format the Root Partition: + +```bash +sudo mkfs.ext4 /dev/nvme0n1p2 +``` + +**Adjust disk and partition names and numbers as needed.** + + +## Step 6: Mount the Partitions + +Before launching the installer, we need to **manually mount** the partitions: + +### Mount the Root Partition: + +```bash +sudo mount /dev/nvme0n1p2 /mnt +``` + +### Create and Mount EFI Directory: + +```bash +sudo mkdir -p /mnt/boot/efi +sudo mount /dev/nvme0n1p1 /mnt/boot/efi +``` + +**Adjust disk and partition names and numbers as needed.** + +Now we’re ready to launch the installer. + + +## Step 7: Launch the AxOS Installer + +1. Open the **AxOS Install** application from the menu. +2. Proceed through the installation. +3. When you get to **"Installation disk and partitioning"**, choose **Manual Partitioning**. + +### Configure the Mount Points: + +* For the **EFI partition**: + + * Set mount point to `/boot/efi` + * Set **Do Not Format** (since we already formatted it) +* For the **Linux root partition**: + + * Set mount point to `/` + * Set **Do Not Format** + +4. Continue through the installer +5. Once installation finishes, reboot + + +## Step 8: Configure GRUB to Detect Windows + +After rebooting into AxOS: + +### 1. Open a terminal and edit the GRUB config: + +```bash +sudo nano /etc/default/grub +``` + +### 2. Find this line: + +```bash +GRUB_DISABLE_OS_PROBER=true +``` + +Change it to: + +```bash +GRUB_DISABLE_OS_PROBER=false +``` + +> **Save and Exit Nano**: +> +> * Press `Ctrl + O` (to save) +> * Press `Enter` (to confirm filename) +> * Press `Ctrl + X` (to exit) + +### 3. Detect Windows: + +```bash +sudo os-prober +``` + +If it returns your Windows installation, proceed. + + +## Step 9: Generate GRUB Config + +Choose the appropriate command depending on your system: + +### BIOS Systems: + +```bash +sudo grub-mkconfig -o /boot/grub/grub.cfg +``` + +### UEFI Systems: + +```bash +sudo grub-mkconfig -o /boot/efi/EFI/grub/grub.cfg +``` + +> ⚠️ If you are not sure what to choost stick to BIOS System. + + +## Final Step: Reboot + +Now reboot your system: + +```bash +sudo reboot now +``` + +You should now see the **GRUB boot menu**, with both **AxOS** and **Windows** listed. + +--- + +## Done From f0fb77e14bfca2a98917eba976552c957c917234 Mon Sep 17 00:00:00 2001 From: ArchDevs Date: Sat, 12 Jul 2025 13:57:30 +0400 Subject: [PATCH 2/4] removed: unnecessary disk note --- src/content/docs/guides/dual-boot.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/src/content/docs/guides/dual-boot.md b/src/content/docs/guides/dual-boot.md index 9263c52..54484af 100644 --- a/src/content/docs/guides/dual-boot.md +++ b/src/content/docs/guides/dual-boot.md @@ -14,16 +14,12 @@ How to do a full **dual boot installation** with **Windows 11** and **AxOS** (Wi We need to shrink an existing partition to make room for AxOS. -> ⚠️ **Important Note**: -> It’s strongly recommended to install Linux on the **same physical disk (SSD/HDD)** where Windows is installed. Installing it on a second disk can cause bootloader issues or system instability. - ### Instructions: 1. Press `Win + X` → choose **Disk Management** *or* Press `Win + R`, type `diskmgmt.msc`, and hit Enter. 2. In the Disk Management window: - * Right-click on a partition with enough free space (e.g. your D: drive) * Click **"Shrink Volume"** * Enter how much you want to shrink (in MB). For example, `50000` for 50 GB From f8fa33929f7106dd0f2ea66f5dafe36a7f8e0ab7 Mon Sep 17 00:00:00 2001 From: ArchDevs Date: Sat, 12 Jul 2025 14:06:46 +0400 Subject: [PATCH 3/4] updated: structure of the guide --- src/content/docs/guides/dual-boot.md | 35 +++++++--------------------- 1 file changed, 8 insertions(+), 27 deletions(-) diff --git a/src/content/docs/guides/dual-boot.md b/src/content/docs/guides/dual-boot.md index 54484af..a0a977c 100644 --- a/src/content/docs/guides/dual-boot.md +++ b/src/content/docs/guides/dual-boot.md @@ -98,12 +98,7 @@ EFI partition done! > Confirm with `y` if asked. -We’ve now created two partitions, but they are still **unformatted**. - - -## Step 5: Format the Partitions - -We now format the two partitions to make them usable by the system. +We’ve now created two partitions. > ⚠️ The **partition names** depend on your disk: > @@ -111,24 +106,8 @@ We now format the two partitions to make them usable by the system. > * If your disk is `/dev/nvme0n1`, partitions will be `/dev/nvme0n1p1`, `/dev/nvme0n1p2`, etc. > *(Note the **"p"** before the number of partition)* -### Format the EFI Partition: - -```bash -sudo mkfs.fat -F32 /dev/nvme0n1p1 -``` - -### Format the Root Partition: - -```bash -sudo mkfs.ext4 /dev/nvme0n1p2 -``` - -**Adjust disk and partition names and numbers as needed.** - -## Step 6: Mount the Partitions - -Before launching the installer, we need to **manually mount** the partitions: +## Step 5: Mount the Partitions ### Mount the Root Partition: @@ -148,7 +127,7 @@ sudo mount /dev/nvme0n1p1 /mnt/boot/efi Now we’re ready to launch the installer. -## Step 7: Launch the AxOS Installer +## Step 6: Launch the AxOS Installer 1. Open the **AxOS Install** application from the menu. 2. Proceed through the installation. @@ -158,16 +137,18 @@ Now we’re ready to launch the installer. * For the **EFI partition**: + * Set **FAT32** format * Set mount point to `/boot/efi` - * Set **Do Not Format** (since we already formatted it) + * For the **Linux root partition**: + * Set **ext4** format * Set mount point to `/` - * Set **Do Not Format** 4. Continue through the installer 5. Once installation finishes, reboot +**Adjust disk and partition names and numbers as needed.** ## Step 8: Configure GRUB to Detect Windows @@ -182,7 +163,7 @@ sudo nano /etc/default/grub ### 2. Find this line: ```bash -GRUB_DISABLE_OS_PROBER=true +GRUB_DISABLE_OS_PROBER ``` Change it to: From 4ce8b134ef3c66939ef7960e76a0d3b552b20378 Mon Sep 17 00:00:00 2001 From: ArchDevs Date: Sat, 12 Jul 2025 14:10:21 +0400 Subject: [PATCH 4/4] added: notes for better UX --- src/content/docs/guides/dual-boot.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/content/docs/guides/dual-boot.md b/src/content/docs/guides/dual-boot.md index a0a977c..c7dd534 100644 --- a/src/content/docs/guides/dual-boot.md +++ b/src/content/docs/guides/dual-boot.md @@ -109,7 +109,7 @@ We’ve now created two partitions. ## Step 5: Mount the Partitions -### Mount the Root Partition: +### Mount the Root Partition (Linux filesystem): ```bash sudo mount /dev/nvme0n1p2 /mnt @@ -122,7 +122,7 @@ sudo mkdir -p /mnt/boot/efi sudo mount /dev/nvme0n1p1 /mnt/boot/efi ``` -**Adjust disk and partition names and numbers as needed.** +> **Adjust disk and partition names and numbers as needed.** Now we’re ready to launch the installer. @@ -148,7 +148,7 @@ Now we’re ready to launch the installer. 4. Continue through the installer 5. Once installation finishes, reboot -**Adjust disk and partition names and numbers as needed.** +> **Adjust disk and partition names and numbers as needed.** ## Step 8: Configure GRUB to Detect Windows