1SYSTEMD-SLEEP.CONF(5) systemd-sleep.conf SYSTEMD-SLEEP.CONF(5)
2
6 systemd-sleep.conf, sleep.conf.d - Suspend and hibernation
7 configuration file
8
10 /etc/systemd/sleep.conf
11 /etc/systemd/sleep.conf.d/*.conf
13 /run/systemd/sleep.conf.d/*.conf
15 /usr/lib/systemd/sleep.conf.d/*.conf
17
19 systemd supports four general power-saving modes:
20 suspend
22 a low-power state where execution of the OS is paused, and complete
23 power loss might result in lost data, and which is fast to enter
24 and exit. This corresponds to suspend, standby, or freeze states as
25 understood by the kernel.
26 hibernate
28 a low-power state where execution of the OS is paused, and complete
29 power loss does not result in lost data, and which might be slow to
30 enter and exit. This corresponds to the hibernation as understood
31 by the kernel.
32 hybrid-sleep
34 a low-power state where execution of the OS is paused, which might
35 be slow to enter, and on complete power loss does not result in
36 lost data but might be slower to exit in that case. This mode is
37 called suspend-to-both by the kernel.
38 suspend-then-hibernate
40 A low power state where the system is initially suspended (the
41 state is stored in RAM). If not interrupted within the delay
42 specified by HibernateDelaySec=, the system will be woken using an
43 RTC alarm and hibernated (the state is then stored on disk).
44 Settings in these files determine what strings will be written to
46 /sys/power/disk and /sys/power/state by systemd-sleep(8) when
47 systemd(1) attempts to suspend or hibernate the machine. See
48 systemd.syntax(7) for a general description of the syntax.
49
51 The default configuration is defined during compilation, so a
52 configuration file is only needed when it is necessary to deviate from
53 those defaults. By default, the configuration file in /etc/systemd/
54 contains commented out entries showing the defaults as a guide to the
55 administrator. This file can be edited to create local overrides.
56 When packages need to customize the configuration, they can install
58 configuration snippets in /usr/lib/systemd/*.conf.d/ or
59 /usr/local/lib/systemd/*.conf.d/. The main configuration file is read
60 before any of the configuration directories, and has the lowest
61 precedence; entries in a file in any configuration directory override
62 entries in the single configuration file. Files in the *.conf.d/
63 configuration subdirectories are sorted by their filename in
64 lexicographic order, regardless of in which of the subdirectories they
65 reside. When multiple files specify the same option, for options which
66 accept just a single value, the entry in the file with the
67 lexicographically latest name takes precedence. For options which
68 accept a list of values, entries are collected as they occur in files
69 sorted lexicographically.
70 Files in /etc/ are reserved for the local administrator, who may use
72 this logic to override the configuration files installed by vendor
73 packages. It is recommended to prefix all filenames in those
74 subdirectories with a two-digit number and a dash, to simplify the
75 ordering of the files.
76 To disable a configuration file supplied by the vendor, the recommended
78 way is to place a symlink to /dev/null in the configuration directory
79 in /etc/, with the same filename as the vendor configuration file.
80
82 The following options can be configured in the [Sleep] section of
83 /etc/systemd/sleep.conf or a sleep.conf.d file:
84 AllowSuspend=, AllowHibernation=, AllowSuspendThenHibernate=,
86 AllowHybridSleep=
87 By default any power-saving mode is advertised if possible (i.e.
88 the kernel supports that mode, the necessary resources are
89 available). Those switches can be used to disable specific modes.
90 If AllowHibernation=no or AllowSuspend=no is used, this implies
92 AllowSuspendThenHibernate=no and AllowHybridSleep=no, since those
93 methods use both suspend and hibernation internally.
94 AllowSuspendThenHibernate=yes and AllowHybridSleep=yes can be used
95 to override and enable those specific modes.
96 SuspendMode=, HibernateMode=, HybridSleepMode=
98 The string to be written to /sys/power/disk by, respectively,
99 systemd-suspend.service(8), systemd-hibernate.service(8), systemd-
100 hybrid-sleep.service(8), or systemd-suspend-then-
101 hibernate.service(8). More than one value can be specified by
102 separating multiple values with whitespace. They will be tried in
103 turn, until one is written without error. If neither succeeds, the
104 operation will be aborted.
105 SuspendState=, HibernateState=, HybridSleepState=
107 The string to be written to /sys/power/state by, respectively,
108 systemd-suspend.service(8), systemd-hibernate.service(8), systemd-
109 hybrid-sleep.service(8), or systemd-suspend-then-
110 hibernate.service(8). More than one value can be specified by
111 separating multiple values with whitespace. They will be tried in
112 turn, until one is written without error. If neither succeeds, the
113 operation will be aborted.
114 HibernateDelaySec=
116 The amount of time the system spends in suspend mode before the
117 system is automatically put into hibernate mode, when using
118 systemd-suspend-then-hibernate.service(8). Defaults to 2h.
119
121 Example: to exploit the “freeze” mode added in Linux 3.9, one can use
122 systemctl suspend with
123 [Sleep]
125 SuspendState=freeze
126
128 systemd-sleep(8), systemd-suspend.service(8), systemd-
129 hibernate.service(8), systemd-hybrid-sleep.service(8), systemd-suspend-
130 then-hibernate.service(8), systemd(1), systemd.directives(7)
131systemd 246 SYSTEMD-SLEEP.CONF(5)