scottgigawatt / duplex

Docker Utilities for Plex on Synology DSM 🍿

Duplex

Duplex simplifies Plex Media Server management on Synology NAS by providing a Docker Compose configuration with essential tools and utilities.

Overview

The docker-compose.yml file in this repository configures Docker containers for managing a Plex Media Server on a Synology NAS. It includes tools for metadata management, photo cleaning, monitoring, and automated updates.

For more details on the Docker Compose configuration, refer to the docker-compose.yml file in this repository.

Included Tools

• Kometa: Manages Plex Media Server metadata. More info

  Note: Kometa configuration details are in a separate repository and included as a submodule in this repository at config/kometa for easier deployment.

• ImageMaid: Cleans Plex Media Server photos. More info
• PATTRMM: Schedule and run media processing tasks. GitHub
• Tautulli: Monitors and tracks Plex Media Server usage. GitHub
• Notifiarr: Provides notifications for various media server activities. GitHub
• Watchtower: Automatically updates Docker container base images. GitHub

Usage

Starting the Service Stack

Follow these steps to start the Duplex service stack:

1. Clone this repository to your Synology NAS, including the submodules.

   git clone --recurse-submodules https://github.com/yourusername/duplex.git

2. Navigate to the directory containing the docker-compose.yml file.

3. Open a terminal or SSH into your Synology NAS.

4. Run docker-compose up -d to start the containers in detached mode.

5. Access the services through their respective endpoints.

6. Configure services to connect to Plex using the gateway IP address of the Docker bridge network. Find this IP in Container Manager -> Network for DSM 7.2 and above.

Managing Docker Config Environment Variables

Manage Docker configuration environment variables in the .env file. Override these variables easily on the command line when starting the Docker Compose stack:

KOMETA_TAG="latest" docker-compose up -d

Adjust the values of these environment variables to your requirements.

Managing the Project with DSM Container Manager

To import this project into DSM 7.2 Container Manager's Project feature:

1. SSH into your Synology system.
2. Clone this repository.
3. In Container Manager, click Project then Create.
4. Provide a title, e.g., duplex.
5. Set the path to the cloned repository.
6. Proceed through UI prompts to finish creating the project.

Refer to the official Synology documentation here for more on Container Manager Projects.

Secure Access to Synology Applications

Use DSM 7 Reverse Proxy to configure secure access to Synology applications. Follow the guide here for DSM 7.

Note: If you encounter "Socket closed" errors when accessing the DSM UI via reverse proxy and trying to open terminals for running containers, enable WebSocket for the reverse proxy record:

1. Go to Control Panel -> Application Portal -> Reverse Proxy.
2. Select Edit for your reverse proxy record.
3. Navigate to the Custom Header tab.
4. From the Create dropdown, select WebSocket.
5. Save the changes to resolve the issue.

Environment Details

Tested on Synology DS916+ running DSM 7.2.1-69057 Update 5, with Docker Compose version v2.9.0-6413-g38f6acd.

License

Licensed under the Apache 2 License - see LICENSE for details.

---

Contribute or provide feedback to improve the Duplex repository. Happy Plexing!