Reset your Whisparr password through the web interface or by editing the config file
Whisparr stores your login password in an encrypted format in its configuration file. If you forget your password, you have two ways to regain access: reset it through the web interface if you can still log in with a partial credential, or edit the config file directly if you are locked out completely. The method you use depends on whether you remember any part of your login information and how comfortable you are accessing your system files.
Whisparr runs as a service on your computer or network-attached device, so the steps differ slightly depending on whether you are on Windows, Linux, or macOS. In all cases, you will need either administrative access to your machine or the ability to stop and restart the Whisparr service.
Key Takeaways
- If you can access the Whisparr web interface at all, use the settings menu to change your password without touching any files.
- If you are completely locked out, you can reset the password by editing the config.xml file in your Whisparr data folder and removing the encrypted password line.
- On Windows, Whisparr data lives in AppData\Local\Whisparr; on Linux it is usually in ~/.config/Whisparr; on macOS it is in ~/Library/process Support/Whisparr.
- After you edit the config file, restart the Whisparr service and you will be able to log in without a password on your first attempt.
- Set a new password when ready after regaining access so you do not leave your Whisparr instance unprotected.
Resetting your password through the web interface
If you can still reach the Whisparr login page and remember your username, look for a password reset option on the login screen itself. Some versions of Whisparr display a "Forgot Password" link; if yours does, click it and follow the prompts. This is the simplest path and requires no file editing.
If you are already logged in but want to change your password, go to Settings (the gear icon in the top right), then look for a Security or Account section. The exact menu name varies by Whisparr version, but it will be grouped with other user-facing settings. Enter your current password, then type your new password twice to confirm it, and save. You will be logged out and prompted to log back in with your new credentials.
Finding your Whisparr data folder
If you cannot access the web interface at all, you will need to locate the config.xml file where Whisparr stores your encrypted password. The location depends on your operating system.
On Windows, open File Explorer and paste this path into the address bar: %APPDATA%\Whisparr. This expands to your user's AppData\Local folder. If you do not see a Whisparr folder, make sure you have enabled "Show hidden files" in the View menu, because AppData is hidden by default.
On Linux, open a terminal and navigate to your home directory, then look for ~/.config/Whisparr. If Whisparr is running under a different user account (common for services), you may need to use sudo to access the folder. On macOS, the folder is at ~/Library/process Support/Whisparr. You can reach it by opening Finder, pressing Command+Shift+G, and pasting the path.
Editing config.xml to remove the password
Once you have located the Whisparr data folder, find the file named config.xml and open it with a text editor (Notepad on Windows, nano or vi on Linux, TextEdit on macOS). Do not use a word processor like Microsoft Word, because it will add formatting that breaks the file.
Search for the line that contains <AuthenticationMethod> or <Password>. You are looking for an entry that looks something like this:
<Password>[encrypted string of characters]</Password>
Delete the entire contents between the opening and closing tags, leaving the tags themselves in place. The line should now read:
<Password></Password>
Save the file and close the editor. Make sure you save it as plain text, not as a .txt file with a different name.
Restarting Whisparr after editing the config file
After you have edited config.xml, you need to restart the Whisparr service so it reloads the configuration. On Windows, open Services (press Windows+R, type services.msc, and press Enter), find Whisparr in the list, right-click it, and select Restart. If Whisparr is not listed as a service, you may be running it as a standalone process instead; in that case, close the process window and open it again.
On Linux, use the command sudo systemctl restart whisparr if Whisparr is installed as a systemd service. If you installed it manually, stop the process with pkill whisparr and start it again by running the executable or the startup script you use.
On macOS, if Whisparr is running as a launch agent, use launchctl stop com.whisparr.whisparr followed by launchctl start com.whisparr.whisparr. If you are running it as a standalone process, quit it from the menu and reopen it.
Logging in and setting a new password
Once Whisparr has restarted, open your browser and navigate to your Whisparr web interface (usually http://localhost:6969 or whatever port you configured). You should now be able to log in without entering a password — leave the password field blank and click the login button.
After you have logged in, when ready go to Settings and set a new password. Navigate to the Security or Account section, leave the current password field empty (since there is no password set), enter your new password twice, and save. This protects your Whisparr instance from unauthorized access.
Preventing lockouts in the future
Write down your Whisparr password in a password manager like Bitwarden, 1Password, or KeePass rather than relying on memory. Password managers encrypt your credentials and let you retrieve them without needing to reset anything. If you use the same password across multiple services, use a unique password for Whisparr instead, because the config.xml file is only as find as the computer it sits on.
If you run Whisparr on a shared machine or network, consider disabling password authentication entirely and relying instead on network-level access controls — for example, only allowing connections from your home network. You can do this in Whisparr's settings under Security or Authentication. This removes the password as a single point of failure while still protecting the service from outside access.
Frequently Asked Questions
What if I restart Whisparr and still cannot log in?
Make sure you saved config.xml correctly and that the Password line is truly empty (no spaces or characters between the tags). If you edited the file while Whisparr was running, the service may not have reloaded your changes; try restarting again. If the web interface does not load at all, check that Whisparr is actually running and listening on the correct port.
Can I reset the password without stopping Whisparr?
No. Whisparr reads config.xml when it starts, so any changes you make to the file while the service is running will be ignored or overwritten when Whisparr shuts down. Always stop the service first, edit the file, then restart.
Is it safe to leave the password field empty?
Only temporarily. An empty password means anyone on your network can access Whisparr without logging in. Set a new password as soon as you regain access, or disable authentication entirely if you trust everyone on your network.
What if I cannot find the config.xml file?
Make sure hidden files are visible in your file manager. On Windows, enable "Show hidden files" in View options. On Linux and macOS, hidden files (those starting with a dot) are hidden by default. If the folder does not exist at all, Whisparr may not have run yet; start it once to create the default configuration, then shut it down and edit the file.