mosquitto_passwd 1 Mosquitto Project Commands mosquitto_passwd manage password files for mosquitto mosquitto_passwd -H hash -c -D passwordfile username mosquitto_passwd -H hash -b passwordfile username password mosquitto_passwd -U passwordfile mosquitto_passwd is a tool for managing password files for the mosquitto MQTT broker. Usernames must not contain ":". Passwords are stored in a similar format to crypt3. -b Run in batch mode. This allows the password to be provided at the command line which can be convenient but should be used with care because the password will be visible on the command line and in command history. -c Create a new password file. If the file already exists, it will be overwritten. If the filename is specified as a dash - then the output will be to stdout. This only really makes sense with -b. -D Delete the specified user from the password file. -H Choose the hash to use. Can be one of argon2id, sha512-pbkdf2, or sha512. Defaults to argon2id. The sha512 option is provided for creating password files for use with Mosquitto 1.6 and earlier. -U This option can be used to upgrade/convert a password file with plain text passwords into one using hashed passwords. It will modify the specified file. It does not detect whether passwords are already hashed, so using it on a password file that already contains hashed passwords will generate new hashes based on the old hashes and render the password file unusable. passwordfile The password file to modify. username The username to add/update/delete. password The password to use when in batch mode. mosquitto_passwd returns zero on success or non-zero on error. Add a user to a new password file: mosquitto_passwd -c /etc/mosquitto/passwd ral Add a user to an existing password file: mosquitto_passwd /etc/mosquitto/passwd ral Add a user to an existing password file, passing the password on the command line: mosquitto_passwd -b /etc/mosquitto/passwd ral z2Dr0BsvtZ Update the password for a user in an existing password file: mosquitto_passwd /etc/mosquitto/passwd ral Add a user to an existing password file using the sha512 hash for Mosquitto 1.6 compatibility: mosquitto_passwd -H sha512 /etc/mosquitto/passwd ral Delete a user from a password file mosquitto_passwd -D /etc/mosquitto/passwd ral mosquitto 7 mosquitto 8 mosquitto.conf 5 mqtt 7 Roger Light roger@atchoo.org