tuned-main.conf(5)

πŸ“¦
version 2.28.0 Β· 3 versions
, in alpine 3.24, arch rolling, centos-stream 10, centos-stream 9, fedora 43, fedora 44, nixpkgs unstable

✨ tuned-main.conf β€” the file format description ✨

okay bestie, so this is the manual for tuned-main.conf(5), and it's literally just the format description of the TuneD global config file. sit down, grab a strawberry drink πŸ“, and let's get into it.

πŸ’– NAME πŸ’–

tuned-main.conf β€” the TuneD global configuration file, aka the main character of your tuning setup πŸ‘‘

🌸 SYNOPSIS 🌸

/etc/tuned/tuned-main.conf

that's it. one path. she's lowkey iconic for it.

πŸ¦‹ DESCRIPTION πŸ¦‹

this page is here to tell you the format of the TuneD global configuration file, and bestie, the format is ini-file. so yes, it's giving very key = value, very classic, very demure πŸŽ€

πŸ’… the settings (yes, all of them)

  • daemon=BOOL β€” this one decides whether TuneD uses the daemon or not. it's a boolean value, so it's True or 1 when the daemon is enabled, and False or 0 when it's disabled. and listen, turning the daemon off is not recommended, fr fr, because so many functions just will not work without it. like: no D-Bus, no settings rollback, no hotplug support, no dynamic tuning, ... the list goes on 😭
  • dynamic_tuning=BOOL β€” this one says whether dynamic tuning is enabled. boolean again: True or 1 means dynamic tuning is on, False or 0 means it's off. if it's off, only the static tuning gets used. and heads up, even if you enable it here, you can still individually disable it inside plugins. also it's only applicable if daemon is enabled.
  • sleep_interval=INT β€” the TuneD daemon gets periodically woken up after INT seconds and checks for events. by default this is set to 1 second. if you have a Python 2 interpreter with the patch from Red Hat Bugzilla #917709 applied, this controls the responsiveness time of TuneD to commands (so like, if you request a profile switch, it may take up to 1 second before TuneD reacts). increase this number for higher responsiveness times and more power savings (because of the lower number of wakeups). but if you have an unpatched Python 2 interpreter, this setting will have no visible effect, because the interpreter will poll 20 times per second. only applicable if daemon is enabled.
  • update_interval=INT β€” the update interval for dynamic tuning, in seconds. the TuneD daemon is periodically woken up after INT seconds, it updates its monitors, calculates new tuning parameters for enabled plugins and applies the changes. plugins that have dynamic tuning disabled are not processed. by default INT is set to 10 seconds. the TuneD daemon does not periodically wake if dynamic tuning is globally disabled (peep dynamic_tuning) or if this setting is set to 0. this must be a multiple of sleep_interval. only applicable if daemon is enabled.
  • recommend_command=BOOL β€” this controls whether the recommend functionality is enabled or not. boolean value: True or 1 means the recommend command is enabled, False or 0 means disabled. if it's disabled, the recommend command will not be available in the CLI, TuneD will not parse recommend.conf and will return one hardcoded profile (by default balanced). only applicable if daemon is enabled. by default it's set to True.
  • reapply_sysctl=BOOL β€” this controls whether to reapply sysctl settings from /run/sysctl.d/*.conf, /etc/sysctl.d/*.conf and /etc/sysctl.conf after the TuneD sysctl settings are applied. those are the locations supported by sysctl --system, excluding the ones that contain sysctl configuration files provided by system packages. so if reapply_sysctl is set to True or 1, the TuneD sysctl settings will not override user-provided system sysctl settings. if it's set to False or 0, the TuneD sysctl settings will override the system sysctl settings. by default it's set to True.
  • reapply_sysctl_exclude=LIST β€” a comma or semicolon separated list of sysctl parameter patterns to exclude from reapplication when reapply_sysctl is enabled. this is useful for protecting runtime sysctl changes made by Kubernetes CNI plugins or other services that set sysctls dynamically. it supports shell-style wildcards (*, ?, [seq]). by default the list is empty.

Example:

reapply_sysctl_exclude = net.ipv4.ip_forward, net.ipv6.conf.*.forwarding
  • default_instance_priority=INT β€” the default instance (unit) priority. by default it's 0. each unit has a priority which is by default preset to the INT. it can be overridden in the TuneD profile by the priority option. TuneD units are processed in the order defined by their priorities, meaning the unit with the lowest number is processed first. πŸ₯‡

πŸ”₯ EXAMPLE πŸ”₯

here's a whole vibe, copy-paste ready:

no_daemon = 0
dynamic_tuning = 1
sleep_interval = 1
update_interval = 10
recommend_command = 0
reapply_sysctl = 1
reapply_sysctl_exclude = net.ipv4.ip_forward, net.bridge.bridge-nf-call-iptables
default_instance_priority = 0

πŸŽ€ FILES πŸŽ€

/etc/tuned/tuned-main.conf

she's the moment. she's the file. πŸ’œ

🌈 SEE ALSO 🌈

go read that one next bestie, it's the sister page 🫢

πŸ‘‘ AUTHOR πŸ‘‘

written by Jaroslav Ε karvada <jskarvad@redhat.com>. absolute legend, no cap.

πŸ’€ REPORTING BUGS πŸ’€

found a bug? don't suffer in silence, report it to https://bugzilla.redhat.com/. they wanna hear it fr fr πŸ™ˆ

okay that's the whole page, you ate that. now go tune something responsibly πŸ’…βœ¨

signing off β€” this was Jaroslav Ε karvada, 15 Oct 2013, and that's the tuned-main.conf(5) energy, periodt. πŸŒΈπŸ¦‹πŸŽ€

πŸ“¦ where this page comes from