# Enable cgroups v1 Compatibility Mode

### Background

This tutorial applies to **GRUB-based systems like Ubuntu/Debian**. By modifying the GRUB kernel parameter `systemd.unified_cgroup_hierarchy=0`, we force the system to use cgroups v1 hierarchy mode. 

***

### Procedure

* **If you are on Windows:**

1. Open Command Prompt (cmd).
2. Enter the following command to access the Multipass virtual machine:

   bash

   ```
   multipass shell ubuntu-pedge
   ```
3. Then, proceed with the subsequent operations.

* **If you are on Ubuntu/Debian,** you can skip this step.

#### 1. Edit GRUB Configuration File

**Command Execution**

```bash
sudo vim /etc/default/grub
```

**Modification**

Locate the `GRUB_CMDLINE_LINUX` parameter line and **append** the following content (preserve existing parameters, separate with spaces):

```diff
- GRUB_CMDLINE_LINUX="..."
+ GRUB_CMDLINE_LINUX="... systemd.unified_cgroup_hierarchy=0"
```

**Complete Example**

Modified line may appear as (actual parameters may vary depending on the system):

```bash
GRUB_CMDLINE_LINUX="quiet splash systemd.unified_cgroup_hierarchy=0"
```

**Important Notes**

* Do NOT duplicate the parameter if it already exists
* Recommended to back up the original file

***

#### 2. Generate New GRUB Configuration and Reboot

**Update GRUB**

```bash
sudo update-grub
```

This command generates `/boot/grub/grub.cfg` to apply changes.

**System Reboot**

```bash
sudo reboot
```

***

By completing this tutorial, you have successfully switched to cgroups v1 mode. 


---

# Agent Instructions: 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:

```
GET https://titannet.gitbook.io/titan-network-en/galileo-testnet/titan-agent-installation-guide/linux/enable-cgroups-v1-compatibility-mode.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.