selinux_mode
SELinux is the access control layer that the Red Hat family turns on by
default. It refuses what its policy does not allow, even to a process that
runs as root. selinux_mode sets whether SELinux enforces its policy or
only reports what the policy would refuse: enforcing (SELinux refuses
what its policy does not allow) or permissive (it only reports). MMX
sets the running mode and the SELINUX= line in /etc/selinux/config,
which the node reads at boot. MMX does not disable SELinux.
Four modules change SELinux, each in one way:
selinux_booleanswitches a permission of the policy on or off;selinux_file_contextgives the files of a path another label;selinux_portgives a network port another type;selinux_modesets whether SELinux enforces its policy or only reports.
Inputs
mode(enforcingorpermissive; required): sets the running mode and the SELINUX= line; on a kernel that runs without SELinux, writes the line, creates /.autorelabel, and reports value.reboot_required: true
Outputs
The node task's result holds these fields. A later node task reads them as .node_tasks.<id>.<field>, where <id> is the node task's id.
statuschangevalue.reboot_required
What a dryrun reports
Supported; reads the running mode and the configuration.
Retries and time limits
Bounded automatic retries by default; retry: false turns them off.
The node task takes the time limits time_limit and time_limit_per_try; without them, the project's node_task_defaults apply. mmx describe-module task describes the settings every node task accepts.
Examples
Make SELinux enforce its policy
- selinux_mode:
mode: enforcing
On the node, MMX reads the running mode and the SELINUX= line. When
either differs, MMX sets the running mode and writes the line. When both
already say enforcing, the node task reports unchanged.
Turn SELinux on for a node that runs without it
- selinux_mode:
mode: enforcing
- reboot: {}
On a kernel that runs with SELinux disabled, selinux_mode writes the
configuration, creates /.autorelabel so the next boot gives every file
its label, and reports reboot_required: true in .this_node_task.value
until the reboot. The reboot node task then restarts the node.
How it works
- The module inspects before it acts, and changes the running node and
/etc/selinux/configtogether. disabledis not a value ofmode.- On a node where SELinux is not installed, the node task reports
skippedwith the reason "SELinux is not enabled on this node". The fact.node.selinux.modesaysenforcing,permissive, ordisabled(facts).
Errors and what they mean
| The reason holds | What it means, and what to do |
|---|---|
the kernel command line has selinux=0, which keeps SELinux off at every boot whatever /etc/selinux/config says; remove it first, ... |
SELinux stays off at every boot whatever the file says, so the node task fails before it changes anything. Remove selinux=0 from the kernel command line, for example with grubby --update-kernel ALL --remove-args selinux, as the reason says. |
Tested on
Distributions: Rocky Linux 9, AlmaLinux 10, Fedora 45.
The suite tests/integration/firewalld_and_selinux.py runs on seven distributions: Debian 12 and 13, Ubuntu 24.04 and 26.04, Rocky Linux 9, AlmaLinux 10, and Fedora 45. On the three distributions that use SELinux, Rocky Linux 9, AlmaLinux 10, and Fedora 45, it runs in a virtual machine with SELinux enforcing, as installed. On the other four it runs in a container without SELinux and
checks that the module reports skipped. The validation
record has the latest results.
Not in a suite: selinux_mode creating /.autorelabel itself on a real
node. Rocky Linux creates the file when it boots with SELinux disabled, so
only Go tests reach that path. The change from disabled to enforcing, the
reboot, and the relabel were tested on a Rocky Linux 9 virtual machine.
Why it works this way
disabledis refused. On Enterprise Linux 9,SELINUX=disabledin/etc/selinux/configno longer disables SELinux. The kernel parameterselinux=0does that. Usemode: permissiveto stop enforcement while keeping SELinux enabled.
This page is docs/reference/modules/selinux_mode.md in the MMX repository.