🧩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

1. Edit GRUB Configuration File

Command Execution

sudo vim /etc/default/grub

Modification

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

- 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):

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

sudo update-grub

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

System Reboot

sudo reboot

---

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