man/homed.conf.xml

   1 <?xml version='1.0'?>
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
   4 <!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
   5
   6 <refentry id="homed.conf" conditional='ENABLE_HOMED'
   7     xmlns:xi="http://www.w3.org/2001/XInclude">
   8   <refentryinfo>
   9     <title>homed.conf</title>
  10     <productname>systemd</productname>
  11   </refentryinfo>
  12
  13   <refmeta>
  14     <refentrytitle>homed.conf</refentrytitle>
  15     <manvolnum>5</manvolnum>
  16   </refmeta>
  17
  18   <refnamediv>
  19     <refname>homed.conf</refname>
  20     <refname>homed.conf.d</refname>
  21     <refpurpose>Home area/user account manager configuration files</refpurpose>
  22   </refnamediv>
  23
  24   <refsynopsisdiv>
  25     <para><simplelist>
  26       <member><filename>/etc/systemd/homed.conf</filename></member>
  27       <member><filename>/run/systemd/homed.conf</filename></member>
  28       <member><filename>/usr/lib/systemd/homed.conf</filename></member>
  29       <member><filename>/etc/systemd/homed.conf.d/*.conf</filename></member>
  30       <member><filename>/run/systemd/homed.conf.d/*.conf</filename></member>
  31       <member><filename>/usr/lib/systemd/homed.conf.d/*.conf</filename></member>
  32     </simplelist></para>
  33   </refsynopsisdiv>
  34
  35   <refsect1>
  36     <title>Description</title>
  37
  38     <para>These configuration files control default parameters for home areas/user accounts created and
  39     managed by
  40     <citerefentry><refentrytitle>systemd-homed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
  41
  42   </refsect1>
  43
  44   <xi:include href="standard-conf.xml" xpointer="main-conf" />
  45
  46   <refsect1>
  47     <title>Options</title>
  48
  49     <para>The following options are available in the [Home] section:</para>
  50
  51     <variablelist class='home-directives'>
  52
  53       <varlistentry>
  54         <term><varname>DefaultStorage=</varname></term>
  55         <listitem><para>The default storage to use for home areas. Takes one of <literal>luks</literal>,
  56         <literal>fscrypt</literal>, <literal>directory</literal>, <literal>subvolume</literal>,
  57         <literal>cifs</literal>. For details about these options, see
  58         <citerefentry><refentrytitle>homectl</refentrytitle><manvolnum>1</manvolnum></citerefentry>. If not
  59         configured or assigned the empty string, the default storage is automatically determined: if not
  60         running in a container environment and <filename>/home/</filename> is not itself encrypted, defaults
  61         to <literal>luks</literal>. Otherwise defaults to <literal>subvolume</literal> if
  62         <filename>/home/</filename> is on a btrfs file system, and <literal>directory</literal>
  63         otherwise. Note that the storage selected on the <command>homectl</command> command line always takes
  64         precedence.</para>
  65
  66         <xi:include href="version-info.xml" xpointer="v246"/></listitem>
  67       </varlistentry>
  68
  69       <varlistentry>
  70         <term><varname>DefaultFileSystemType=</varname></term>
  71         <listitem><para>When using <literal>luks</literal> as storage (see above), selects the default file
  72         system to use inside the user's LUKS volume. Takes one of <literal>btrfs</literal>,
  73         <literal>ext4</literal> or <literal>xfs</literal>. If not specified defaults to
  74         <literal>btrfs</literal>. This setting has no effect if a different storage mechanism is used. The
  75         file system type selected on the <command>homectl</command> command line always takes
  76         precedence.</para>
  77
  78         <xi:include href="version-info.xml" xpointer="v246"/></listitem>
  79       </varlistentry>
  80
  81     </variablelist>
  82   </refsect1>
  83
  84   <refsect1>
  85       <title>See Also</title>
  86       <para><simplelist type="inline">
  87       <member><citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
  88       <member><citerefentry><refentrytitle>systemd-homed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry></member>
  89       </simplelist></para>
  90   </refsect1>
  91
  92 </refentry>