Process Container

The process container is built into the application manager and enabled by default. It can be configured in the application manager config file using its unique ID: process:

containers:
  process:
    defaultControlGroup: "foo"

The process container accepts the following configuration settings:

Settings Name	Type	Description
`controlGroups`	object	A two-stage mapping object to allow for more readable code when dealing with v1 cgroups from the System UI via Container::controlGroup. The top-level `keys` are readable group names that are used to interface with Container::controlGroup. The values themselves are `maps` between multiple low-level `cgroup` sub-system names and the actual `cgroup` names within those sub-systems, such as: `controlGroups: foreGround: memory: mem1 cpu: cpu_full backGround: memory: mem2 cpu: cpu_minimal` Note: This mapping is unnecessary and ignored if your system is using v2 cgroups.
`defaultControlGroup`	string	The name of the v2 cgroup that a launched process is placed into. The group is created on demand, but it is never removed again, as it is shared between all applications. When `createControlGroupPerProcess` is set, this is used as the parent for the per-process cgroups instead. Defaults to empty, which leaves the process in the System UI's own cgroup.
`createControlGroupPerProcess`	bool	If set to `true`, each launched process is placed into its own nested v2 cgroup below the `defaultControlGroup`, instead of sharing the `defaultControlGroup` directly. The nested group is named after the application's ID (for example `<defaultControlGroup>/com.example.app`); for quick-launched processes that do not have an application ID yet, a unique `app-<uuid>` name is used instead. In contrast to a shared `defaultControlGroup`, this nested group is exclusive to the process, so it is removed again after the process exited. The default value is `false`. Note: This setting requires v2 cgroups and is ignored otherwise.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.