Heads up! This page uses features your browser doesn't support. Try a modern browser like Firefox or Chrome for the best experience.

How to Reset Your Admin Password 🗝️

Locked out of your Sage.is AI admin account? It happens to the best of us. This guide will walk you through getting back into your account, whether you're running Sage.is AI through Docker or have it running in our Private Cloud.

If You're Using Docker 🐳

Docker users need to take a few extra steps because the application runs inside a container. Don't worry – it's straightforward once you know what to do.

Create Your New Password Hash 🔐

Before you can change your password, you need to convert it into a special encrypted format called a "hash." This is how passwords are safely stored in databases.

Run Apche's htpasswd command on your computer, replacing your-new-password with whatever password you want to use:

htpasswd -bnBC 10 "" 'your-new-password' | tr -d ':\n' | sed 's/\$/\\$/g'&& echo

Important note: The result will be a long string of letters, numbers, and symbols. The sed part of that command adds special characters to escape any $ in the output.

Update Your Password in Docker 🔄

Now you'll actually change the password in your Docker setup. In the command below, replace HASH with the encrypted password you just created, and replace [email protected] with your admin email address.

$2y$10$Hg75JN2nWzd2qhfDntbDKOL/Ii1Fc/biycBxhXHJOjeQM.YkNzV.e

docker run --rm -v sage-open-webui:/data alpine/socat EXEC:"bash -c 'apk add sqlite && echo UPDATE auth SET password='\''HASH'\'' WHERE email='\''[email protected]'\''; | sqlite3 /data/webui.db'", STDIO

If that doesn't work, try this alternative method instead:

Alternative Method for Docker Users

Some people have trouble with the command above. If it doesn't work for you, try this step-by-step approach:

  1. Start a temporary container connected to your Sage.is AI data:

    docker run -it --rm -v sage-open-webui:/path/to/data alpine

    Note: Replace /path/to/data with your actual volume path.

  2. Install the tools you need:

    apk add apache2-utils sqlite
  3. Create your password hash:

    htpasswd -bnBC 10 "" your-new-password | tr -d ':'
  4. Update your password in the database:

    sqlite3 /path/to/data/webui.db

    Then type this SQL command:

    UPDATE auth SET password='HASH' WHERE email='[email protected]';

    Press Ctrl + D to exit.

If You use Sage.is AI in our Private Cloud 💻

If your team uses Sage.is AI in our Private Cloud please contact Sage.is Support and we'll get you back up and running in no time!


📖 Following these steps should get you back into your Sage.is AI admin account quickly. If you run into problems, try searching our community forum for your specific issue.