Media app shows an empty library or no folders
Symptoms
Section titled “Symptoms”You installed a media app such as Plex, Jellyfin, Emby, Navidrome, Sonarr, Radarr or Lidarr. One of these happens:
- The library is empty after you add it.
- The folder browser inside the app shows no media folders, or an empty one.
- Only some of your files show up.
- Sonarr, Radarr or Lidarr do not list
/data/media1as a root folder.
The app runs in a container and sees your files at a different path than your server does. In v6, the media apps see your folders like this:
| Folder on your server | Path inside the app |
|---|---|
| Media Folder 1 | /data/media1 |
| Media Folder 2 | /data/media2 |
| Media Folder 3 | /data/media3 |
| Downloads Folder | /data/downloads |
For the paths of every app, including books, photos and audiobooks, see the App reference.
Navidrome gets the media folders but not the Downloads Folder. If your library is fine but finished downloads never reach it, see Sonarr, Radarr or Lidarr don’t import finished downloads.
The library is empty when one of these is true:
- The folder on your server is empty or not mounted.
- You set a media folder after you installed the app, so the app never got it. This is most often Media Folder 2 or 3. These apps don’t install without at least one media folder set.
- The library in the app points at the server path instead of the
/datapath. - Your user cannot read the folder.
- The app has not scanned the folder yet.
Work through the checks below in order. Stop when your library fills.
1. Check the files on the server
Section titled “1. Check the files on the server”-
In Deployrr, go to System > Folders. Note the path next to Media Folder 1. If it says
NOT SET, set it as shown in Set a folder, then go to check 2. -
List the folder on the server. Replace
YOUR_MEDIA_FOLDERwith the path from step 1:Terminal window ls YOUR_MEDIA_FOLDER -
Look for your media type folders, such as
moviesandtv. If the list is empty, the problem is on the server, not in the app.
If your media is on a NAS and the list is empty, the share is not mounted:
- Mount it again with Rclone or with SMB and NFS mounts.
- If Rclone says the mount folder is not empty, see Rclone mount folder is not empty.
- If the files are there after a reboot but the app was empty at start, the NAS was not ready when the app started. Use System > Mounts > Rclone > Delay Media Apps. See part 5 of Mount a NAS share with Rclone. For SMB, NFS or a local disk, see Apps are stopped or show empty folders after a reboot.
When the files show on the server again, restart the app from Apps > Manage Apps: pick the app and choose Restart, or Start if it is stopped. See Install and manage apps from the Apps menu.
2. Check that the app has the folder
Section titled “2. Check that the app has the folder”An app only gets the media folders that were set when you installed it. To see why the order matters, watch Deployrr 5 walkthrough: Setup Folders at 22:17 (shows Deployrr v5; menus differ in v6).
-
Look inside the app’s container. Replace
APPwith the app’s name, such asjellyfin:Terminal window sudo docker exec APP ls /dataWith the Deployrr bash aliases:
dexec APP ls /data. -
Look for
media1, andmedia2ormedia3if you use them. If a folder is missing, the app does not have it. -
To confirm, read the app’s compose file. Replace
YOUR_DOCKER_FOLDERwith your Docker folder path,HOSTNAMEwith your server’s hostname andAPPwith the app’s name:Terminal window grep MEDIADIR YOUR_DOCKER_FOLDER/compose/HOSTNAME/APP.ymlA line that starts with
#is off. For example,# - $MEDIADIR1:/data/media1means the app has no Media Folder 1. -
If the lines are off, but you set the folder in System > Folders, reinstall the app. Reinstalling keeps the app’s data but replaces its compose file, so make the backups on that page first. For a running app, start the reinstall from Apps > Browse Apps. Manage Apps shows Reinstall only for a stopped app.
-
If the lines are on and the path in
.envchanged, recreate the app. Go to Tools > Stack Manager > Recreate and pick the app. See Stack Manager. With the Deployrr bash aliases:dcrec APP.
Recreating does not turn on a media folder that was off. Only a reinstall does. To pick the right action for other changes, see Restart, Recreate or Reinstall an app. For the full explanation, see Apps you installed before you set a media folder.
3. Use the path inside the app
Section titled “3. Use the path inside the app”In the app, add the library with the /data path, not the path on your server. Do not type a path like /home/YOUR_USER/media/movies. The app cannot see that path.
Pick the folder for one media type, such as /data/media1/movies or /data/media1/tv, not /data/media1 itself. Use your own folder names; these are examples.
Jellyfin
- Go to Admin > Dashboard, then Server > Libraries.
- Click Add Media Library.
- Pick the content type, such as movies or shows, and give the library a name.
- Add a folder and browse to
/data/media1/movies. If the browser doesn’t show it, type the path. - Save the library.
Emby
- Open the server dashboard and go to Library.
- Click Add Media Library.
- Pick the Content Type and enter a display name.
- Under Library Paths, click + and browse to
/data/media1/movies, or type the path and click OK. - Save the library.
Plex
Add a library, pick its type, then add a folder and pick /data/media1/movies. The menu names change between Plex versions, so follow what your Plex shows.
Sonarr, Radarr and Lidarr
- Go to Settings > Media Management.
- Under Root Folders, add a root folder. In Sonarr and Radarr the button is Add Root Folder. In Lidarr it is Add (+), and you also give the folder a Name.
- Pick the folder for that app’s media, such as
/data/media1/tvfor Sonarr,/data/media1/moviesfor Radarr or/data/media1/musicfor Lidarr.
Do not use /data/downloads or a folder inside it as a root folder. Sonarr, Radarr and Lidarr need the download folder and the root folder to be different places. If finished downloads don’t reach the root folder, see Sonarr, Radarr or Lidarr don’t import finished downloads.
To link these apps to each other and to a media server, see Connect your apps to each other.
4. Check who owns the folder
Section titled “4. Check who owns the folder”Apps run as your Linux user and its main group. Deployrr makes your user the owner only of a folder it creates for you. A folder that already existed keeps its own owner. A folder owned by root, or a NAS share your user cannot read, gives an empty or partial library.
-
Check the owner. Replace
YOUR_MEDIA_FOLDERwith your path:Terminal window ls -ld YOUR_MEDIA_FOLDER -
For a local folder owned by
root, check the path again. Make sure it is your media folder and not/or your home folder. -
Make your user the owner. Replace
YOUR_USERwith your Linux username andYOUR_MEDIA_FOLDERwith your path. The command assumes your main group has the same name as your user, which is the default on most systems:Terminal window sudo chown YOUR_USER:YOUR_USER YOUR_MEDIA_FOLDER -
If the folder holds subfolders you cannot read, run
ls -ldon one of them. Fix the owner the same way.
To see a root-owned mount folder fixed by hand, watch Rclone SMB mount on Ubuntu/LXC: folder owner at 11:09 (manual setup).
On a NAS mount, the NAS decides who can read. Check the share permissions on the NAS, and that the account you mount with can read the share. See UDMS part 07: Permission Denied Errors (manual setup). For more, see The app cannot read or write the folder.
5. Scan the library
Section titled “5. Scan the library”A new library can take a while to fill. Media servers scan in the background, and big libraries can take a long time.
- Open the app.
- Find the library and start a scan, or refresh it. The menu text depends on the app.
- Wait, then check again.
Check it worked
Section titled “Check it worked”- Run
sudo docker exec APP ls /data/media1with your app name. You see your media type folders. - Open the app. The library shows your titles.
- In Sonarr, Radarr or Lidarr, the root folder list shows a path under
/data/media1.

