Community Solution

Share a ZimaOS Folder With Plex: Volume Mapping

A user could not expose a ZimaOS media folder to Plex; the thread resolved the difference between friendly folder paths and container volume paths.

Why a Folder Visible in ZimaOS May Not Appear in Plex

ZimaOS Files can present a friendly shared-folder path, while Plex runs in a container and can only browse host folders explicitly mounted into that container. This difference was the core confusion in the solved community thread.

Plex container volume mappings in ZimaOS with several media folders
Community screenshot showing the user's initial Plex volume mappings, including several different host and container media paths.
ZimaOS shared folder settings for the Concert 1 media folder
Community screenshot showing the friendly shared-folder path /Concert and SMB access information for the Concert 1 folder.

Understand the Host Path and Plex Path

Each Plex volume entry maps a ZimaOS host path to a path inside the Plex container. The community initially suggested a simple structure such as /DATA/Media → /Media, then browsing /Media/Movies, /Media/Music or similar inside Plex.

ZimaOS Files view showing the Concert 1 folder on storage
Community screenshot showing the Concert storage location and the Concert 1 folder in the ZimaOS Files interface.
ZimaOS Files view showing AppData Backup Concert Documents Downloads Gallery and Media folders
Community screenshot showing the ZimaOS-HD folder structure while the user was trying to identify the correct filesystem path for Plex.

The Working Mapping From the Community Case

The user's friendly folder view showed /Concert/Concert 1, but the working Plex configuration revealed the actual mounted path as /media/Concert/Concert 1. That distinction resolved the problem in this specific setup.

Working Plex volume settings mapping media Concert folder into the container
Community screenshot posted after the issue was solved, showing the working /media/Concert/Concert 1 mapping in Plex settings.

Keep Plex Mounts Simple

Instead of creating many overlapping mounts, one parent media mount is easier to understand and maintain when the storage layout allows it. Plex documents media-library organization in its media support documentation.

Check Permissions After the Mount Exists

If Plex can see the mounted path but cannot read files, then investigate permissions. Do not change permissions broadly until the path mapping itself is correct. For ZimaOS context, see the media server hardware guide and ZimaOS storage guide.