From 82fef2db312846fe68e8f7498f11525bd6684c25 Mon Sep 17 00:00:00 2001 From: Marek Skrobacki Date: Tue, 7 Oct 2025 14:39:27 +0100 Subject: [PATCH] fix: docs(troubleshooting) update deprecated password hash algorithm MD5 password hashes are no longer supported on modern Debian-based systems, as PAM removed MD5 support starting with Debian 11 (2021) [1]. When MD5 is used, no error is shown, but authentication to IPA silently fails. This change updates the documentation to use the more modern SHA-512 algorithm. [1]: https://metadata.ftp-master.debian.org/changelogs/main/p/pam/unstable_changelog Change-Id: I398b771c28ed65e71b279d48cb504afb8383e525 Signed-off-by: Marek Skrobacki --- doc/source/admin/troubleshooting.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/admin/troubleshooting.rst b/doc/source/admin/troubleshooting.rst index 67c18eef5..2dccce552 100644 --- a/doc/source/admin/troubleshooting.rst +++ b/doc/source/admin/troubleshooting.rst @@ -56,7 +56,7 @@ Generate a password hash with following command: .. code-block:: console - $ openssl passwd -1 -stdin | sed 's/\$/\$\$/g' + $ openssl passwd -6 -stdin | sed 's/\$/\$\$/g' Add ``rootpwd=""`` value or add ``sshkey=""`` on the ``kernel_append_params``