2 <!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4 <!-- SPDX-License-Identifier: LGPL-2.1+ -->
6 <refentry id=
"homed.conf" conditional='ENABLE_RESOLVE'
7 xmlns:
xi=
"http://www.w3.org/2001/XInclude">
9 <title>homed.conf
</title>
10 <productname>systemd
</productname>
14 <refentrytitle>homed.conf
</refentrytitle>
15 <manvolnum>5</manvolnum>
19 <refname>homed.conf
</refname>
20 <refname>homed.conf.d
</refname>
21 <refpurpose>Home area/user account manager configuration files
</refpurpose>
25 <para><filename>/etc/systemd/homed.conf
</filename></para>
26 <para><filename>/etc/systemd/homed.conf.d/*.conf
</filename></para>
27 <para><filename>/run/systemd/homed.conf.d/*.conf
</filename></para>
28 <para><filename>/usr/lib/systemd/homed.conf.d/*.conf
</filename></para>
32 <title>Description
</title>
34 <para>These configuration files control default parameters for home areas/user accounts created and
36 <citerefentry><refentrytitle>systemd-homed.service
</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
</para>
40 <xi:include href=
"standard-conf.xml" xpointer=
"main-conf" />
43 <title>Options
</title>
45 <para>The following options are available in the
<literal>[Home]
</literal> section:
</para>
47 <variablelist class='home-directives'
>
50 <term><varname>DefaultStorage=
</varname></term>
51 <listitem><para>The default storage to use for home areas. Takes one of
<literal>luks
</literal>,
52 <literal>fscrypt
</literal>,
<literal>directory
</literal>,
<literal>subvolume
</literal>,
53 <literal>cifs
</literal>. For details about these options, see
54 <citerefentry><refentrytitle>homectl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>. If not
55 configured or assigned the empty string, the default storage is automatically determined: if not
56 running in a container environment and
<filename>/home/
</filename> is not itself encrypted, defaults
57 to
<literal>luks
</literal>. Otherwise defaults to
<literal>subvolume
</literal> if
58 <filename>/home/
</filename> is on a btrfs file system, and
<literal>directory
</literal>
59 otherwise. Note that the storage selected on the
<command>homectl
</command> command line always takes
60 precedence.
</para></listitem>
64 <term><varname>DefaultFileSystemType=
</varname></term>
65 <listitem><para>When using
<literal>luks
</literal> as storage (see above), selects the default file
66 system to use inside the user's LUKS volume. Takes one of
<literal>ext4
</literal>,
67 <literal>xfs
</literal> or
<literal>btrfs
</literal>. If not specified defaults to
68 <literal>ext4
</literal>. This setting has no effect if a different storage mechanism is used. The
69 file system type selected on the
<command>homectl
</command> command line always takes
70 precedence.
</para></listitem>
77 <title>See Also
</title>
79 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
80 <citerefentry><refentrytitle>systemd-homed.service
</refentrytitle><manvolnum>8</manvolnum></citerefentry>