Need help? Join the Norri Discord.Beta information

Network Shares

Mount your SMB/CIFS or NFS share on the computer running Norri, then add the mounted folder as a library. Norri does not mount shares or accept NAS usernames and passwords in the library form.

Docker

  1. Configure the share on the Docker host using your NAS or operating system’s mounting tools.
  2. Confirm that the mounted directory contains your media and is readable by the user and group configured for Norri.
  3. In your Docker configuration, replace a media folder’s host path with the mounted share path. Keep the container path below /media.
  4. Start or recreate the Norri container.
  5. Go to Settings → Libraries, add a library, and select the matching folder below /media.

For example, this media entry in the Compose file’s volumes section connects a mounted Movies share:

      - "/mnt/nas/movies:/media/Movies:ro"

Replace /mnt/nas/movies with your host’s mounted folder. Keep the entry aligned with the other volume entries. In Norri, select /media/Movies, not the host path or an smb:// address.

For separate shares or a mixture of local disks and NAS folders, use the separate-folder mappings in the installation guide.

Keep the media bind mount read-only. The container does not need SYS_ADMIN or DAC_READ_SEARCH capabilities to read a share that the host has already mounted.

Unraid

Use an Unraid share or a mounted remote share as the container’s Media host path. Select the corresponding folder beneath /media when creating the Norri library. Configure NAS credentials and reconnection on Unraid, outside Norri.

Keep the share connected

Configure the Docker host to make the mount available before starting Norri. Store share credentials using the host’s supported credential mechanism rather than putting them in a library path.

If a share becomes unavailable

Restore the mount on the host before rescanning. Norri checks for inaccessible library roots and retains existing library records. Files found missing during a scan are marked unavailable rather than automatically deleted.

After the files return, scan the library to make them available again. Only use Library Health to remove an unavailable record when you intend to remove it from Norri; that cleanup does not delete the media file.

Troubleshooting

  • The folder is empty: check the host mount first, then the container mapping. A disconnected share can leave an empty mount directory behind.
  • Permission denied: verify both NAS permissions and the host user’s access. For Docker, check PUID and PGID.
  • The path is rejected: use an absolute local path within Norri’s configured media root. UNC paths and SMB URLs are not library paths.
  • Changes are not detected immediately: run a library scan. Network filesystems do not always deliver file-change notifications like local disks.

See Libraries and Scheduled Tasks for scanning options.