plexinc/pms-docker
Pms Docker
This project provides containerized distribution templates and images for deploying a media server. It enables the operation of a media server within Docker or Kubernetes environments, utilizing package management charts to streamline installation and management of home cinema libraries.
The project focuses on high-performance video processing through hardware accelerated transcoding, which is achieved by passing through graphics processing unit devices to the container. It ensures data persistence by mapping host directories for configuration databases and large-scale media libraries.
The system covers a broad range of operational capabilities, including network configuration for bridge or host modes, ingress routing for external hostname mapping, and user permission alignment to manage file access. It also includes mechanisms for server identity authentication using claim tokens and automated binary updates triggered by image tags.
Deployment is supported through Kubernetes Helm charts and Docker images.
Features
- Containerized Server Deployments - Provides containerized distribution templates and images for deploying and isolating media server instances.
- Media Server Containers - Runs a Plex Media Server inside a container to isolate the application and simplify installation.
- GPU-Accelerated Containers - Provides a container image pre-configured with GPU drivers and libraries to enable high-performance hardware-accelerated video transcoding.
- Container Storage Persistence - Ensures data durability across service restarts by mapping host-level storage to the container.
- Media Server Docker Images - Provides a containerized distribution of a media server for streamlined deployment and management.
- Helm Chart Deployments - Ships a Helm chart for deploying and orchestrating the media server on Kubernetes clusters.
- Hardware-Accelerated Transcoders - Leverages GPU hardware contexts to provide high-performance video transcoding and reduced CPU load.
- Container Volume Bindings - Maps host directories to the container to ensure persistent storage for media libraries and configuration.
- GPU Device Passthroughs - Exposes host GPU devices to the container to enable high-performance hardware accelerated video transcoding.
- Container Image Tagging - Utilizes specific image tags to trigger the automatic download and installation of the latest server binaries.
- Containerized Networking Interfaces - Configures network interfaces and ingress routes to make the containerized server accessible externally.
- Remote Binary Updaters - Automatically downloads and installs the latest public or beta binaries on startup via image tags.
- Package Management Charts - Provides Kubernetes Helm charts to streamline the deployment and scaling of the media server.
- Hardware-Accelerated Video Pipelines - Configures video processing pipelines that leverage dedicated graphics hardware to accelerate encoding and transcoding tasks.
- Container Networking Configurations - Supports various network modes including bridge, host, and macvlan to control local communication.
- Instance Authentication - Implements a process for linking server instances to user accounts using claim tokens during initial setup.
- User ID Mapping Configurations - Aligns internal container user and group IDs with host system IDs to manage file read and write permissions.
- Automated Server Maintenance - Automates routine server maintenance including binary updates and configuration identity management.
- Host Network Mode Containers - Supports running the container with host networking to allow direct communication with the local network.
- Claim Token Associations - Provides a mechanism to associate the containerized server with a user account via claim tokens.
- Media & Communication - Media server for personal streaming.
- Plex Infrastructure - Official Docker image for Plex.
