diff --git a/man/directives-template.xml b/man/directives-template.xml
index 5ab0beb4cf..5038061467 100644
--- a/man/directives-template.xml
+++ b/man/directives-template.xml
@@ -51,6 +51,15 @@
+
+ Home Area/User Account directives
+
+ Directives for configuring home areas and user accounts via
+ systemd-homed.service8.
+
+
+
+
UDEV directives
diff --git a/man/homectl.xml b/man/homectl.xml
index 632c8b95bb..14877a0cde 100644
--- a/man/homectl.xml
+++ b/man/homectl.xml
@@ -504,9 +504,9 @@
Selects the storage mechanism to use for this home directory. Takes one of
luks, fscrypt, directory,
subvolume, cifs. For details about these mechanisms, see
- above. If a new home directory is created and the storage type is not specifically specified defaults
- to luks if supported, subvolume as first fallback if supported,
- and directory if not.
+ above. If a new home directory is created and the storage type is not specifically specified,
+ homed.conf5
+ defines which default storage to use.
@@ -525,9 +525,10 @@
When LUKS2 storage is used configures the file system type to use inside the home
directory LUKS2 container. One of ext4, xfs,
- btrfs. If not specified defaults to ext4. Note that
- xfs is not recommended as its support for file system resizing is too
- limited.
+ btrfs. If not specified
+ homed.conf5
+ defines which default file system type to use. Note that xfs is not recommended as
+ its support for file system resizing is too limited.
@@ -837,6 +838,7 @@ homectl update lafcadio --pkcs11-token-uri=…
systemd1,
systemd-homed.service8,
+ homed.conf5,
userdbctl1,
useradd8,
cryptsetup8
diff --git a/man/homed.conf.xml b/man/homed.conf.xml
new file mode 100644
index 0000000000..03590feeaa
--- /dev/null
+++ b/man/homed.conf.xml
@@ -0,0 +1,84 @@
+
+
+
+
+
+
+ homed.conf
+ systemd
+
+
+
+ homed.conf
+ 5
+
+
+
+ homed.conf
+ homed.conf.d
+ Home area/user account manager configuration files
+
+
+
+ /etc/systemd/homed.conf
+ /etc/systemd/homed.conf.d/*.conf
+ /run/systemd/homed.conf.d/*.conf
+ /usr/lib/systemd/homed.conf.d/*.conf
+
+
+
+ Description
+
+ These configuration files control default parameters for home areas/user accounts created and
+ managed by
+ systemd-homed.service8.
+
+
+
+
+
+
+ Options
+
+ The following options are available in the [Home] section:
+
+
+
+
+ DefaultStorage=
+ The default storage to use for home areas. Takes one of luks,
+ fscrypt, directory, subvolume,
+ cifs. For details about these options, see
+ homectl1. If not
+ configured or assigned the empty string, the default storage is automatically determined: if not
+ running in a container enviroment and /home/ is not itself encrypted, defaults
+ to luks. Otherwise defaults to subvolume if
+ /home/ is on a btrfs file system, and directory
+ otherwise. Note that the storage selected on the homectl command line always takes
+ precedence.
+
+
+
+ DefaultFileSystemType=
+ When using luks as storage (see above), selects the default file
+ system to use inside the user's LUKS volume. Takes one of ext4,
+ xfs or btrfs. If not specified defaults to
+ ext4. This setting has no effect if a different storage mechanism is used. The
+ file system type selected on the homectl command line always takes
+ precedence.
+
+
+
+
+
+
+ See Also
+
+ systemd1,
+ systemd-homed.service8
+
+
+
+
diff --git a/man/rules/meson.build b/man/rules/meson.build
index 5bbee35e9f..941e248d72 100644
--- a/man/rules/meson.build
+++ b/man/rules/meson.build
@@ -18,6 +18,7 @@ manpages = [
['file-hierarchy', '7', [], ''],
['halt', '8', ['poweroff', 'reboot'], ''],
['homectl', '1', [], 'ENABLE_HOMED'],
+ ['homed.conf', '5', ['homed.conf.d'], 'ENABLE_RESOLVE'],
['hostname', '5', [], ''],
['hostnamectl', '1', [], 'ENABLE_HOSTNAMED'],
['hwdb', '7', [], 'ENABLE_HWDB'],
diff --git a/man/systemd-homed.service.xml b/man/systemd-homed.service.xml
index a51bd36d41..049b7e9097 100644
--- a/man/systemd-homed.service.xml
+++ b/man/systemd-homed.service.xml
@@ -100,6 +100,7 @@
See Also
systemd1,
+ homed.conf5,
homectl1,
pam_systemd_home8,
userdbctl1