diff --git a/admin_manual/configuration_server/config_sample_php_parameters.rst b/admin_manual/configuration_server/config_sample_php_parameters.rst index 6bbc80db2..5cbab8ad0 100644 --- a/admin_manual/configuration_server/config_sample_php_parameters.rst +++ b/admin_manual/configuration_server/config_sample_php_parameters.rst @@ -1604,6 +1604,43 @@ use. The Web server user must have write access to this directory. +Hashing +------- + +Nextcloud uses the Argon2 algorithm (available with PHP >= 7.2 if compiled +with it) to create hashes by its own and exposes its configuration options as +following. The default depends on the PHP build. More information can be +found at: https://www.php.net/manual/en/function.password-hash.php + + +:: + + 'hashingMemoryCost' => 65536, + +The allowed maximum memory in KiB to be used by the algorithm for computing a +hash. The smallest possible value is 8. Values that undershoot the minimum +will be ignored in favor of the default. + +:: + + 'hashingTimeCost' => 4, + +The allowed maximum time in seconds that can be used by the algorithm for +computing a hash. The value must be an integer, and the minimum value is 1. + +Values that undershoot the minimum will be ignored in favor of the default. + +:: + + 'hashingThreads' => 1, + +The allowed number of CPU threads that can be used by the algorithm for +computing a hash. The value must be an integer, and the minimum value is 1. + +Rationally it does not help to provide a number higher than the available +threads on the machine. Values that undershoot the minimum will be ignored +in favor of the default. + :: 'hashingCost' => 10,