Community Solution

Set Up Plex on CasaOS: Media Paths, Library Mapping, and Current Remote Access

An August 2023 IceWhale tutorial that installed qBittorrent and Plex on CasaOS, aligned their Docker volume paths, imported a copyright-safe Big Buck Bunny sample into Plex, and demonstrated TV login. Current Plex remote access has account and networking requirements not covered by the old screenshots.

IceWhale's 2023 tutorial explains an enduring Docker lesson: the download client and Plex must agree on where the media exists on the host and what path Plex sees inside its container. The article used the open movie Big Buck Bunny as a safe demonstration, moved the file into the host's media directory, then added the mapped /Media folder inside Plex.

The storage-path logic still matters today. The remote-access section needs a current boundary, though, because Plex now documents explicit account, router, and remote-playback requirements that are more specific than simply signing into the TV app.

CasaOS qBittorrent settings showing host /DATA paths mapped into the download container
The historical tutorial first identified where qBittorrent downloads landed on the CasaOS host.

The Core Lesson Is Host Path vs Container Path

The qBittorrent container downloaded files to an internal path while CasaOS stored them under a host /DATA location. Plex had its own volume mapping and could only browse paths explicitly exposed to its container.

This is why “the file exists on the NAS” does not automatically mean Plex can see it.

Align the Download and Plex Media Locations

The tutorial offered two options: move completed media into Plex's existing host media directory, or change the Plex volume mapping so both applications point at the same host storage.

For a current deployment, choose the final media folder before downloading large libraries so you do not need repeated moves and rescans.

Plex Add Folder dialog browsing the mapped /Media container path
Plex should browse the container-side path, such as /Media, after the host folder has been mapped.

Create the Plex Library from the Container-Side Folder

After mapping media, create a Movies, TV, Music, or other library and select the container path. Keep Plex's configuration/database path persistent separately from the replaceable container image.

The old tutorial briefly discussed torrent and magnet searches but deliberately used Big Buck Bunny as its example. A current evergreen page should keep the lawful example rather than encouraging users to obtain copyrighted media without permission.

Current Plex Remote Access Has Its Own Setup Page

Plex currently requires the server to be signed into a Plex account for Remote Access. Automatic router configuration can use UPnP/NAT-PMP; manual forwarding requires an external port forwarded to the Plex server's internal TCP port 32400.

Use the current Plex remote-access requirements instead of assuming the 2023 TV-linking screenshots alone make a server remotely reachable.

TV Account Linking Is Client Authentication, Not Router Configuration

Plex TV app displaying a link code for authorizing the television with a Plex account
Entering the TV PIN links the client to the Plex account; it does not configure the NAS router path by itself.

Remote Streaming May Trigger Transcoding

When the remote client cannot direct-play the original file because of bandwidth or codec limitations, Plex may transcode it. That can turn a lightweight NAS workload into a CPU/GPU-heavy one.

Test an actual remote stream at the quality you intend to use before assuming the server hardware is sufficient.

Existing Plex Servers Need a Different Migration Workflow

A later reply asked why opening Plex on CasaOS routed to an existing server. Migrating an established Plex installation is not the same as creating a second blank server. Preserve the Plex database/configuration and account claim state when moving an existing library.

Keep Plex Configuration Separate from the Media Library

The 2023 tutorial focused heavily on getting a movie into /Media, but a long-lived Plex server also needs a persistent configuration/database path. That folder contains library metadata, watched state, posters, settings, and other server state.

Media can live on large HDD storage while Plex configuration lives on a faster SSD, as long as both host mappings remain stable.

Remote Playback Is Limited by Upload Bandwidth Too

Even a powerful server cannot direct-stream a high-bitrate file remotely if the home Internet connection does not have enough upload capacity. Plex may lower quality or transcode to fit the available bandwidth.

Test from a true external network—such as cellular data—rather than only another device on the home Wi-Fi when validating Remote Access.

UPnP Convenience and Manual Port Forwarding Have Different Tradeoffs

Current Plex support allows automatic router configuration through UPnP/NAT-PMP when the router supports it. Manual forwarding gives the administrator explicit control but requires the correct public/private port mapping and a stable internal server address.

If the ISP uses CGNAT, ordinary inbound forwarding may not work even when the Docker container is configured correctly.

Do Not Expose the CasaOS Dashboard Alongside Plex

Plex Remote Access is designed specifically for the media server. It does not require the CasaOS management interface itself to be published to the Internet. Keep the management UI private and expose only the service that needs remote reachability.

Avoid Losing Library Paths During Container Edits

The historical tutorial warns that changing volume settings restarts the app. The important modern interpretation is to preserve the same host-to-container media path when recreating or updating Plex. If the path changes from /Media to another internal location, Plex can interpret the library as missing until the mapping is restored.

Plex on CasaOS FAQ

Why can qBittorrent see a file while Plex cannot?

The two containers may have different volume mappings and therefore different filesystem views.

Does linking a Plex TV app enable remote access to the server?

No. Client linking and server Remote Access are separate steps.

Which internal port does current Plex documentation use for manual Remote Access forwarding?

TCP port 32400 on the Plex Media Server.