update/index music database after folder content change

For help and support with Universal Media Server
Forum rules
Please make sure you follow the Problem Reporting Guidelines before posting if you want a reply
Post Reply
Lammerts
Posts: 31
Joined: Wed Dec 06, 2023 12:35 am

update/index music database after folder content change

Post by Lammerts »

when i did a fresh install of UMS it took some time for UMS to index all audio files (MP3, FLAC, DTS)
I made some changes in folder structure and found UMS giving some errors not finding files.
Is there a way to delete/remove/update the database?
User avatar
mik_s
Moderator
Posts: 1766
Joined: Wed Aug 23, 2017 11:03 pm
Location: UK

Re: update/index music database after folder content change

Post by mik_s »

If you just want to re-scan your media it might be better to use the "Reset the cache" option in the settings.
This will re-scan to update metadata but will leave played status alone.
This should also clean up entries for files that do not exist but that should happen automatically.
Screenshot 2026-03-10 000945.png
Screenshot 2026-03-10 000945.png (7.94 KiB) Viewed 126888 times
If you need to delete the database it is located in your configuration folder.
On windows it is "C:\ProgramData\UMS\database"
On Linux, from your previous logs on it is "/home/ums/.config/UMS/database" but I think this could be different on other versions of Linux.

Make sure UMS is not running when you delete it. When UMS is started again a new one will be made and fully scans all your media.

If you move files around UMS will update the database by removing the original entries if they cannot be found, and creating new entries for the new location as long as it is in a shared folder.
The "error" messages are not errors but just notifying of this change and would disappear when UMS is restarted.
Logs are important for us to help, Please follow This Link before asking for support. Just a forum cleaner, Will help if I can but no expert.
Lammerts
Posts: 31
Joined: Wed Dec 06, 2023 12:35 am

Re: update/index music database after folder content change

Post by Lammerts »

Thanks for the explanation. I will test the clear Cache option.

I found out there is a hidden folder (on Linux) home/ums/.config/UMS/database in where there are 3 files. 1 file is about 103Mb and i guess this one holds the media data.
ums1.JPG
ums1.JPG (23.67 KiB) Viewed 126871 times
ums2.JPG
ums2.JPG (60.98 KiB) Viewed 126871 times
Post Reply