# 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.