1MOSQUITTO_PASSWD(1)                Commands                MOSQUITTO_PASSWD(1)
2
3
4

NAME

6       mosquitto_passwd - manage password files for mosquitto
7

SYNOPSIS

9       mosquitto_passwd [-c | -D] passwordfile username
10
11       mosquitto_passwd -b passwordfile username password
12
13       mosquitto_passwd -U passwordfile
14

DESCRIPTION

16       mosquitto_passwd is a tool for managing password files for the
17       mosquitto MQTT broker.
18
19       Usernames must not contain ":". Passwords are stored in a similar
20       format to crypt(3).
21

OPTIONS

23       -b
24           Run in batch mode. This allows the password to be provided at the
25           command line which can be convenient but should be used with care
26           because the password will be visible on the command line and in
27           command history.
28
29       -c
30           Create a new password file. If the file already exists, it will be
31           overwritten.
32
33       -D
34           Delete the specified user from the password file.
35
36       -U
37           This option can be used to upgrade/convert a password file with
38           plain text passwords into one using hashed passwords. It will
39           modify the specified file. It does not detect whether passwords are
40           already hashed, so using it on a password file that already
41           contains hashed passwords will generate new hashes based on the old
42           hashes and render the password file unusable.
43
44       passwordfile
45           The password file to modify.
46
47       username
48           The username to add/update/delete.
49
50       password
51           The password to use when in batch mode.
52

EXAMPLES

54       Add a user to a new password file:
55
56       ·   mosquitto_passwd -c /etc/mosquitto/passwd ral
57
58       Delete a user from a password file
59
60       ·   mosquitto_passwd -D /etc/mosquitto/passwd ral
61

BUGS

63       mosquitto bug information can be found at
64       https://github.com/eclipse/mosquitto/issues
65

SEE ALSO

67       mosquitto(8), mosquitto.conf(5), mqtt(7)
68

AUTHOR

70       Roger Light <roger@atchoo.org>
71
72
73
74Mosquitto Project                 04/26/2019               MOSQUITTO_PASSWD(1)
Impressum