Resetting Your Admin Password

Step-by-step guides for resetting your admin password in Docker and local installations.

For Docker Deployments

Step 1: Generate a New Password Hash

Create a bcrypt hash of your new password. Replace your-new-password with the password you want to use:

htpasswd -bnBC 10 "" your-new-password | tr -d ':\n'

note

The output will include a bcrypt hash with special characters. Any $ characters in the hash must be triple-escaped (replaced with \\\) when used in the Docker command in Step 2.

Step 2: Update the Password in Docker

Replace HASH with the bcrypt hash from Step 1 (triple-escaping any $ characters) and admin@example.com with your admin email:

docker run --rm -v hrida-ai:/data alpine/socat EXEC:"bash -c 'apk add sqlite && echo UPDATE auth SET password='\''HASH'\'' WHERE email='\''admin@example.com'\''; | sqlite3 /data/hridaai.db'", STDIO

If the above command fails, use the alternate method below.

Alternate Docker Method

The one-liner above can fail in some environments because the alpine/socat image does not include bash. Use this step-by-step approach instead:

1. Start an Alpine container with the HridaAI volume mounted:

   docker run -it --rm -v hrida-ai:/data alpine

2. Install required tools:

   apk add apache2-utils sqlite

3. Generate the bcrypt hash:

   htpasswd -bnBC 10 "" your-new-password | tr -d ':'

4. Update the password:

   sqlite3 /data/hridaai.db

   UPDATE auth SET password='HASH' WHERE email='admin@example.com';
   -- Exit sqlite: Ctrl+D

For Local Installations

Step 1: Generate a New Password Hash

htpasswd -bnBC 10 "" your-new-password | tr -d ':\n'

Step 2: Update the Password

Navigate to the hrida-ai directory and run:

sqlite3 backend/data/hridaai.db "UPDATE auth SET password='HASH' WHERE email='admin@example.com';"

Replace HASH with the bcrypt hash from Step 1 and admin@example.com with your admin email.

Resetting All Data

If you want to completely reset HridaAI — including all user data, settings, and passwords — delete the hridaai.db file.

Step 1: Locate hridaai.db

If you're unsure where hridaai.db is located, find it with a Python shell:

import os
import hridaai

# Show where the HridaAI package is installed
print("HridaAI is installed at:", hridaai.__file__)

# Construct the expected database path
db_path = os.path.join(os.path.dirname(hridaai.__file__), "data", "hridaai.db")

if os.path.exists(db_path):
    print("hridaai.db found at:", db_path)
else:
    print("hridaai.db not found at:", db_path)
    print("Try: find / -name 'hridaai.db' 2>/dev/null")

Step 2: Delete hridaai.db

rm /path/to/hridaai.db

warning

Deleting hridaai.db removes all stored data — user accounts, settings, chat history, and passwords. Only do this if you need a complete fresh start.