<?xml version='1.0'?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<!-- SPDX-License-Identifier: LGPL-2.1-or-later -->

<refentry id="homed.conf" conditional='ENABLE_HOMED'
    xmlns:xi="http://www.w3.org/2001/XInclude">
  <refentryinfo>
    <title>homed.conf</title>
    <productname>systemd</productname>
  </refentryinfo>

  <refmeta>
    <refentrytitle>homed.conf</refentrytitle>
    <manvolnum>5</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>homed.conf</refname>
    <refname>homed.conf.d</refname>
    <refpurpose>Home area/user account manager configuration files</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <para><simplelist>
      <member><filename>/etc/systemd/homed.conf</filename></member>
      <member><filename>/run/systemd/homed.conf</filename></member>
      <member><filename>/usr/local/lib/systemd/homed.conf</filename></member>
      <member><filename>/usr/lib/systemd/homed.conf</filename></member>
      <member><filename>/etc/systemd/homed.conf.d/*.conf</filename></member>
      <member><filename>/run/systemd/homed.conf.d/*.conf</filename></member>
      <member><filename>/usr/local/lib/systemd/homed.conf.d/*.conf</filename></member>
      <member><filename>/usr/lib/systemd/homed.conf.d/*.conf</filename></member>
    </simplelist></para>
  </refsynopsisdiv>

  <refsect1>
    <title>Description</title>

    <para>These configuration files control default parameters for home areas/user accounts created and
    managed by
    <citerefentry><refentrytitle>systemd-homed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>

  </refsect1>

  <xi:include href="standard-conf.xml" xpointer="main-conf" />

  <refsect1>
    <title>Options</title>

    <para>The following options are available in the [Home] section:</para>

    <variablelist class='home-directives'>

      <varlistentry>
        <term><varname>DefaultStorage=</varname></term>
        <listitem><para>The default storage to use for home areas. Takes one of <literal>luks</literal>,
        <literal>fscrypt</literal>, <literal>directory</literal>, <literal>subvolume</literal>,
        <literal>cifs</literal>. For details about these options, see
        <citerefentry><refentrytitle>homectl</refentrytitle><manvolnum>1</manvolnum></citerefentry>. If not
        configured or assigned the empty string, the default storage is automatically determined: if not
        running in a container environment and <filename>/home/</filename> is not itself encrypted, defaults
        to <literal>luks</literal>. Otherwise defaults to <literal>subvolume</literal> if
        <filename>/home/</filename> is on a btrfs file system, and <literal>directory</literal>
        otherwise. Note that the storage selected on the <command>homectl</command> command line always takes
        precedence.</para>

        <xi:include href="version-info.xml" xpointer="v246"/></listitem>
      </varlistentry>

      <varlistentry>
        <term><varname>DefaultFileSystemType=</varname></term>
        <listitem><para>When using <literal>luks</literal> as storage (see above), selects the default file
        system to use inside the user's LUKS volume. Takes one of <literal>btrfs</literal>,
        <literal>ext4</literal> or <literal>xfs</literal>. If not specified defaults to
        <literal>btrfs</literal>. This setting has no effect if a different storage mechanism is used. The
        file system type selected on the <command>homectl</command> command line always takes
        precedence.</para>

        <xi:include href="version-info.xml" xpointer="v246"/></listitem>
      </varlistentry>

    </variablelist>
  </refsect1>

  <refsect1>
      <title>See Also</title>
      <para><simplelist type="inline">
      <member><citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
      <member><citerefentry><refentrytitle>systemd-homed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry></member>
      </simplelist></para>
  </refsect1>

</refentry>
