Skip to content

Client Troubleshooting

Find tips for common problems on this page.

Tmp not found

Corruption checks require a temp folder to write the db file. This may be a couple hundred megabytes or more. Set the TMPDIR environment variable to a writable path, or mount /tmp to resolve the error.

Duplicate Clients

If you have duplicate clients on the website:

  1. Make sure your client has a static hostname.
  2. Then see these instructions to remove the duplicates.

Gibberish Config File

Once you click save in the Web UI, the config file is compressed. It will look like gibberish when you try to edit it. In the rare case the UI is not accessible and the conf file must be edited, you will need to decompress the file with bzcat prior to making your edits. Example:

bzcat /path/to/notifiarr.conf > /output/path/to/notifiarr_decomp.conf
# or
mv /path/to/notifiarr.conf /path/to/notifiarr.conf.bz
bunzip2 /path/to/notifiarr.conf.bz

Clearing Logs

  • To clear logs to make troubleshooting easier - stop the client and rename/remove the log file(s), then restart the client.
  • If you have not previously enabled debug logs you do not need to clear anything.

Forgotten Passwords

Fresh Installs

Execute the below command to print the unencrypted first-start password. This only works for brand new installations.

# Fix the path yourself:
grep ui_password  /path/to/notifiarr/notifiarr.conf

# Unraid usually:
grep ui_password  /mnt/user/appdata/Notifiarr/notifiarr.conf

Liunx & FreeBSD

  • Run these commands to reset the password and restart the application.
# Reset password.
notifiarr --reset
# Restart client (linux).
systemctl restart notifiarr

Windows

  • Run this command, and then restart the application.
notifiarr.exe --reset

Docker & Unraid

  • Run these two commands in your host system's terminal (console or ssh) while the Notifiarr container is running. If your container is named notifiarr then replace Notifiarr with the lowercase version.
docker exec Notifiarr /notifiarr --reset
docker kill --signal=HUP Notifiarr

# Example output with new password:
[INFO] 2023/09/08 09:32:11 New 'admin' user password: four38=Draw
[INFO] 2023/09/08 09:32:11 Writing Config File: /config/notifiarr.conf
  • If you still can't login, restart the container.