home-assistant/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-12-11 01:21:12 -06:00
Code Issues Packages Projects Releases Wiki Activity

Remove outdated CGroups v1 documentation (#40214)

Browse Source 
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
This commit is contained in:
Stefan Agner 2025-07-30 16:46:11 +02:00 committed by GitHub
parent 14944efb0d
commit 266d1e03c3
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 4 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
source/more-info/unsupported/cgroup_version.markdown
View File

@ -1,26 +1,17 @@
---
title: "CGroup Version"
title: "CGroup version"
description: "More information on why CGroup version marks the installation as unsupported."
---
## The issue
Supervisor depends on a particular version of Docker CGroup to be in use since
it depends on its features to work properly.
Supervisor prefers CGroups version 2 as it depends on its features to work properly.
Currently Supervisor requires CGroup v1 in a supervised installation.
However, the feature set changes and improves over time and therefore, the minimal
required version may change in the future. When that happens, it will be communicated
before we publish a version that will require you to upgrade CGroups.
It seems that on your system CGroups is not available or an unknown CGroups version is in use.
## The solution
If your host uses CGroup v2, add this to the Linux kernel boot parameters: `systemd.unified_cgroup_hierarchy=0` and then reboot your operating system.
In a supervised installation if you have switched to CGroup v2 you will need to
revert what you did. Or you can re-run the [supervised installer](https://github.com/home-assistant/supervised-installer)
to fix it. Please be sure to reboot the system after the installation is done.
Make sure CGroups v2 is available and enabled on your operating system.
You should never see this issue on Home Assistant OS as all versions of the OS
ship with a supported CGroup version.