• v0.2.1-alpha
    All checks were successful
    Release Docker Image / Build & Push Docker Image (release) Successful in 5m31s
    Pre-Release

    scriptos released this 2026-04-05 20:31:32 +00:00 | 29 commits to master since this release

    Release Notes – v0.2.1-alpha

    Release Date: April 5, 2026


    Overview

    This release brings a much-requested quality-of-life improvement for administrators: a CLI-based password reset command. No more deleting the database just because someone forgot their password or lost their TOTP device — simply run a single docker exec command and you're back in business. 🎉


    New Features

    CLI Password Reset (reset-password)

    Administrators can now reset any user's password directly from the command line without restarting the container or touching the database manually.

    docker exec -it keywarden ./keywarden reset-password --username <name>
    
    • Generates a secure random password and prints it to the terminal
    • Automatically forces the user to change the password on next login
    • Clears any active account lockout (failed login attempts & lockout timer)
    • Optional --reset-mfa flag to disable MFA (e.g. when the TOTP device is lost):
      docker exec -it keywarden ./keywarden reset-password --username <name> --reset-mfa
      

    CLI Help Command

    A new help subcommand shows all available CLI commands and usage examples:

    docker exec -it keywarden ./keywarden help
    

    Documentation

    • Admin Guide: Added new "CLI Commands" section documenting the reset-password and help commands.
    • Troubleshooting: Updated "Forgot Admin Password" and "Account Locked Out" sections to reference the new CLI reset command instead of the old "delete the database" workaround.

    Changelog

    Commit Description
    f893d26 fix: enforce LF line endings for shell scripts (.gitattributes)
    68777a5 feat: add CLI password reset command (docker exec reset-password)

    Shoutout: Big thanks to Thomas (aka SchiWaGoA) — this feature was built for you! 🙌

    Downloads