Instructions how to use BootBypass for https://github.com/maharmstone/btrfs

[takeshinishimuralinux]

Could you please provide (demo) instructions how to use BootBypass for https://github.com/maharmstone/btrfs ?

[wesmar]

Using BootBypass with WinBtrfs

Here's a step-by-step guide to load btrfs.sys via BootBypass.

---

1. Copy the driver

Copy btrfs.sys to C:\Windows\System32\drivers\.

---

2. Extract BootBypass

Extract BootBypass.7z (password: github.com) to a local directory, e.g. C:\temp\aaa.

---

3. Edit drivers.ini

The archive already contains a drivers.ini with placeholder values. Open it and update the [Driver0] section for btrfs:

[Config]
Execute=YES
RestoreHVCI=YES
Verbose=NO
DriverDevice=\Device\kvc
IoControlCode_Read=2147491912
IoControlCode_Write=2147491916

[Driver0]
Action=LOAD
AutoPatch=YES
ServiceName=btrfs
ImagePath=\SystemRoot\System32\drivers\btrfs.sys
DriverType=1
StartType=1

Only ServiceName and ImagePath need to change — everything else stays as-is.

---

4. Unblock and run the deployer

Open PowerShell as Administrator, navigate to the extracted directory and run:

cd C:\temp\aaa
Unblock-File .\deploy.ps1
.\deploy.ps1

Confirm with Y when prompted. The full expected output looks like this:

PS C:\temp\aaa> .\deploy.ps1
+------------------------------------------------------------------------------+
¦ BootBypass DEPLOYER                                                          ¦
¦ Deploys the SMSS boot loader and registers it for the next boot.             ¦
+------------------------------------------------------------------------------+
Plan
[INFO] SystemRoot            : C:\WINDOWS
[INFO] BootExecute registry  : HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager
[INFO] Source root           : C:\temp\aaa
[INFO] SMSS executable       : C:\WINDOWS\System32\bb.exe
[INFO] Configuration         : C:\WINDOWS\drivers.ini
Proceed with SMSS deployment? [Y/N]: Y
Deploy
[INFO] drivers.ini backup created: C:\WINDOWS\drivers.ini.bak-XXXXXXXXXXXXXXXX
[ OK ] drivers.ini deployed to C:\WINDOWS\drivers.ini
[ OK ] SMSS deployment completed.
[INFO] bb will execute on the next boot.

---

5. Reboot

Shutdown -r -t 0

BootBypass will load btrfs.sys early during the boot process, before HVCI enforcement kicks in.

---

6. Verify

After reboot, confirm the driver is running:

sc query btrfs

Expected output:

SERVICE_NAME: btrfs
        TYPE               : 1  KERNEL_DRIVER
        STATE              : 4  RUNNING
                                (STOPPABLE, NOT_PAUSABLE, IGNORES_SHUTDOWN)
        WIN32_EXIT_CODE    : 0  (0x0)
        SERVICE_EXIT_CODE  : 0  (0x0)
        CHECKPOINT         : 0x0
        WAIT_HINT          : 0x0

That's it - the btrfs driver is now active. 🎉