Recommend bcrypt passwords everywhere

docs/howto-add-radicale.rst

@@ -3,6 +3,10 @@ How to Add Radicale to SNM
 
 Configuration by @dotlambda
 
+Starting with Radicale 3 (first introduced in NixOS 20.09) the traditional
+crypt passwords, as generated by `mkpasswd`, are no longer supported.  Instead
+bcrypt passwords have to be used which can be generated using `htpasswd`.
+
 .. code:: nix
 
    { config, pkgs, lib, ... }:
@@ -24,7 +28,7 @@ Configuration by @dotlambda
          [auth]
          type = htpasswd
          htpasswd_filename = ${htpasswd}
-         htpasswd_encryption = crypt
+         htpasswd_encryption = bcrypt
        '';
      };
 

docs/quick-start.rst

@@ -20,7 +20,7 @@ Quick Start
        domains = [ "example.com" "example2.com" ];
        loginAccounts = {
            "user1@example.com" = {
-               # mkpasswd -m sha-512 "super secret password" > /hashed/password/file/location
+               # nix run nixpkgs.apacheHttpd -c htpasswd -nbB "" "super secret password" | cut -d: -f2 > /hashed/password/file/location
                hashedPasswordFile = "/hashed/password/file/location";
 
                aliases = [

docs/setup-guide.rst

@@ -46,7 +46,7 @@ should be the most common ones.
        domains = [ <domains> ];
 
        # A list of all login accounts. To create the password hashes, use
-       # mkpasswd -m sha-512 "super secret password"
+       # nix run nixpkgs.apacheHttpd -c htpasswd -nbB "" "super secret password" | cut -d: -f2
        loginAccounts = {
            "user1@example.com" = {
                hashedPassword = "$6$/z4n8AQl6K$kiOkBTWlZfBd7PvF5GsJ8PmPgdZsFGN1jPGZufxxr60PoR0oUsrvzm2oQiflyz5ir9fFJ.d/zKm/NgLXNUsNX/";