Systemd/timers: Difference between revisions
imported>Onny mNo edit summary |
|||
(8 intermediate revisions by 6 users not shown) | |||
Line 1: | Line 1: | ||
{{Systemd/breadcrumb}} | |||
Timers are systemd unit files whose name ends in .timer that control .service files or events. Timers can be used as an alternative to <code>cron</code>. Timers have built-in support for calendar-based events and monotonic time events, and can be run asynchronously. | |||
== Configuration == | |||
The following example timer runs a systemd unit every 5 minutes which invokes a bash script. | |||
<syntaxHighlight lang="nix"> | <syntaxHighlight lang="nix"> | ||
Line 22: | Line 24: | ||
serviceConfig = { | serviceConfig = { | ||
Type = "oneshot"; | Type = "oneshot"; | ||
User= " | User = "root"; | ||
}; | }; | ||
}; | }; | ||
</syntaxHighlight> | </syntaxHighlight> | ||
The following example starts once a day (at 12:00am). When activated, it triggers the service immediately if it missed the last start time (option Persistent=true), for example due to the system being powered off. | |||
<syntaxHighlight lang="nix"> | |||
... | |||
timerConfig = { | |||
OnCalendar = "daily"; | |||
Persistent = true; | |||
}; | |||
}; | |||
</syntaxHighlight> | |||
More examples can be found at the [https://wiki.archlinux.org/title/Systemd/Timers Arch Wiki] and at the <code>systemd.timer</code> manpage. | |||
== Usage == | |||
List active timers and their current state: | |||
<syntaxhighlight lang="bash"> | |||
systemctl list-timers | |||
</syntaxhighlight> | |||
Manually run a service once for testing purposes: | |||
<syntaxhighlight lang="bash"> | |||
systemctl start hello-world | |||
</syntaxhighlight> | |||
[[Category:systemd]] |
Revision as of 21:35, 24 April 2024
Timers are systemd unit files whose name ends in .timer that control .service files or events. Timers can be used as an alternative to cron
. Timers have built-in support for calendar-based events and monotonic time events, and can be run asynchronously.
Configuration
The following example timer runs a systemd unit every 5 minutes which invokes a bash script.
systemd.timers."hello-world" = {
wantedBy = [ "timers.target" ];
timerConfig = {
OnBootSec = "5m";
OnUnitActiveSec = "5m";
Unit = "hello-world.service";
};
};
systemd.services."hello-world" = {
script = ''
set -eu
${pkgs.coreutils}/bin/echo "Hello World"
'';
serviceConfig = {
Type = "oneshot";
User = "root";
};
};
The following example starts once a day (at 12:00am). When activated, it triggers the service immediately if it missed the last start time (option Persistent=true), for example due to the system being powered off.
...
timerConfig = {
OnCalendar = "daily";
Persistent = true;
};
};
More examples can be found at the Arch Wiki and at the systemd.timer
manpage.
Usage
List active timers and their current state:
systemctl list-timers
Manually run a service once for testing purposes:
systemctl start hello-world