PASSWORD(1)                          User Commands                         PASSWORD(1)

NAME
       password - Create and manage passwords

SYNOPSIS

       password [--algorithm algorithm] [--password password] [--realm realm] user

DESCRIPTION

       The password program creates encrypted (hashed) authentication passwords
       for use by the Ioto embedded web server.

       These hashed passwords are typically stored in the Ioto embedded
       database.

            password --password pass1 joshua


OPTIONS

       --algorithm md5|sha256|sha512|bcrypt
              Specifies the hash algorithm to use. Default is sha256.

              md5      Legacy MD5 (insecure, for compatibility only)
              sha256   SHA-256 (recommended for digest auth)
              sha512   SHA-512 (strongest for digest auth)
              bcrypt   Blowfish-based bcrypt (most secure, for session auth)

       --password password
              Specifies a password to use for the user. If not provided,
              the program will prompt for a password.

       --realm realm
              Specifies the authentication realm. Default is 'example.com'.

OUTPUT FORMAT

       Passwords include an algorithm prefix for self-identification:

              MD5:hash
              SHA256:hash
              SHA512:hash
              BF1:rounds:salt:hash

EXAMPLES

       password alice
              Create a password for user 'alice' using the default sha256
              algorithm. Prompts for password input.

       password --algorithm md5 --realm 'Test Realm' bob
              Create an MD5-hashed password for user 'bob' with a custom realm.

       password --algorithm bcrypt --password secret123 alice
              Create a bcrypt-hashed password for user 'alice' with the
              specified password.

REPORTING BUGS

       Report bugs to dev@embedthis.com.

COPYRIGHT

       Copyright (c) Embedthis Software.

password                           December 2025                        PASSWORD(1)