🧩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

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.

Last updated