> For the complete documentation index, see [llms.txt](https://xgine.gitbook.io/xgine-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xgine.gitbook.io/xgine-docs/getting-started/kernel-mode-installation.md).

# Kernel Mode Installation

This guide covers installing Ragnabot v3 in **Kernel mode**, which provides deeper system-level integration for enhanced performance and detection avoidance.

***

## ⚠️ Important Notes

{% hint style="danger" %}
**Kernel mode will NOT work** if your PC has any of the following:

* **Vanguard** (Riot Games anti-cheat)
* **FACEIT** anti-cheat
* **Active antivirus software** (other than Windows Defender, which must be disabled)

If you have any of these installed, use **Standard mode** instead.
{% endhint %}

{% hint style="warning" %}
**TPM and Secure Boot must be disabled** in your BIOS/UEFI settings for Kernel mode to function properly. If you cannot disable these, use **Standard mode**.
{% endhint %}

***

## 📋 Requirements

| Requirement             | Details                                                                  |
| ----------------------- | ------------------------------------------------------------------------ |
| **Recommended OS**      | Windows 10 20H2                                                          |
| **Alternative OS**      | Windows 11 below 24H2 (with PatchGuard disabled via EfiGuard or similar) |
| **TPM**                 | Disabled                                                                 |
| **Secure Boot**         | Disabled                                                                 |
| **Core Isolation**      | Disabled                                                                 |
| **SmartScreen**         | Disabled                                                                 |
| **Windows Defender**    | Permanently disabled                                                     |
| **Anti-cheat software** | Vanguard, FACEIT, etc. must be uninstalled                               |

{% hint style="info" %}
Windows 10 20H2 is the **recommended** operating system for the smoothest experience with Kernel mode.
{% endhint %}

***

## 🛠️ Installation Steps

Follow these steps **in order** before installing Ragnabot in Kernel mode.

***

### Step 1: Disable Core Isolation (Memory Integrity)

Core Isolation's Memory Integrity feature conflicts with Kernel mode and must be turned off.

1. Open **Windows Security**
2. Go to **Device Security** → **Core isolation details**
3. Turn **off** the **Memory integrity** toggle
4. **Restart your PC**

{% hint style="warning" %}
A restart is **required** after disabling Memory Integrity. The change won't take effect until you reboot.
{% endhint %}

***

### Step 2: Disable SmartScreen

Windows SmartScreen can block Ragnabot components from running.

1. Open **Windows Security**
2. Go to **App & browser control**
3. Click **Reputation-based protection settings**
4. Turn **off** the following:
   * **Check apps and files**
   * **SmartScreen for Microsoft Edge**
   * **SmartScreen for Microsoft Store apps**

***

### Step 3: Disable Windows Defender Permanently

Windows Defender must be fully disabled — not just paused — for Kernel mode to work.

1. Disable **Tamper Protection** first (Windows Security → Virus & threat protection → Manage settings)
2. Use **Defender Control** to disable Defender completely

{% hint style="danger" %}
Defender must be **permanently** disabled, not just temporarily paused. If Defender re-enables itself, Kernel mode will stop working.
{% endhint %}

***

### Step 4: Install Ragnabot (Standard Installation Process)

After completing all the steps above, follow the standard installation process:

1. Download the latest Ragnabot release
2. Extract to your preferred folder
3. Run **Ragnabot.exe**
4. Select **Kernel mode** when prompted

***

## 🔄 Can't Use Kernel Mode?

If you cannot meet the requirements above (e.g., you need Secure Boot, TPM, or have anti-cheat software), use **Standard mode** instead. Standard mode works on all systems without any of these prerequisites.

{% hint style="success" %}
**Standard mode** is fully functional and recommended for most users. Kernel mode is only needed for specific use cases that require deeper system integration.
{% endhint %}

***

## 🔍 Troubleshooting

| Issue                         | Solution                                                          |
| ----------------------------- | ----------------------------------------------------------------- |
| Kernel mode crashes on launch | Verify Core Isolation is off and PC has been restarted            |
| Blue screen (BSOD)            | Ensure Secure Boot and TPM are disabled in BIOS                   |
| Defender keeps re-enabling    | Disable Tamper Protection first, then use Defender Control        |
| SmartScreen blocks files      | Verify all SmartScreen toggles are off                            |
| Windows 11 24H2 not working   | Downgrade to an earlier Windows 11 version or use Windows 10 20H2 |
| Anti-cheat conflict           | Fully uninstall Vanguard/FACEIT before using Kernel mode          |

***

## 💬 Need Help?

If you're still having trouble with Kernel mode installation:

* **Discord**: <https://discord.com/invite/ZD9BNfCe5k>
* **YouTube**: <https://www.youtube.com/@xginex>
* **Facebook**: <https://www.facebook.com/xginez>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://xgine.gitbook.io/xgine-docs/getting-started/kernel-mode-installation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.