Djeex/docudjeex
1
1
Fork 0
Code Issues Pull Requests Projects Wiki Activity

Switch the media stack from Plex to Jellyfin and Overseerr to Seerr

Browse Source
This commit is contained in:
Djeex
2026-08-31 23:38:40 +02:00
parent 81df3351f5
commit 91ea3f9a70
7 changed files with 317 additions and 110 deletions
Download Patch File Download Diff File Expand all files Collapse all files
content/en/3.serveex/5.media/1.jellyfin.md
+227
View File
@@ -0,0 +1,227 @@
---
title: Jellyfin
description: Install Jellyfin, a free and open-source media server, to stream your movies and TV shows from anywhere without a paid subscription.
---
:ellipsis{left=0px width=40rem top=10rem blur=140px zIndex=60}
# Jellyfin
::note
🎯 __Objectives:__
- Install Jellyfin
- Access your media from outside your network
::
[Jellyfin](https://jellyfin.org) is a free, open-source alternative to Plex and Emby. Unlike Plex, it has no paid tiers, no telemetry, and doesn't require an online account to use or manage your server: everything runs locally and stays yours.
It covers the same basics: a media library with metadata and artwork, transcoding (including hardware acceleration), and apps for TV, Android, iOS, Windows, and macOS.
As always, we'll use the [linuxserver.io image](https://docs.linuxserver.io/images/docker-jellyfin).
::note
Unlike Plex, Jellyfin has no cloud relay: to access your server outside your local network, you must expose it yourself (see below), or use a VPN like [Wireguard](/serveex/security/wireguard).
::
## Install Jellyfin
Folder structure:
```text [Directory tree]
root
├── docker
│ └── jellyfin
│ ├── compose.yaml
│ ├── .env
│ └── config
└── media
├── tvseries
├── movies
└── library
```
Create the `movies`, `tvseries`, and `library` folders in `/media`:
```bash [Terminal]
mkdir -p /media/movies /media/library /media/tvseries
```
Open Dockge, click `compose`, name the stack `jellyfin`, and add the following config:
```yaml [compose.yaml]
---
services:
jellyfin:
image: lscr.io/linuxserver/jellyfin:latest
container_name: jellyfin
environment:
- PUID=${PUID}
- PGID=${GUID}
- TZ=Europe/Paris
volumes:
- /docker/jellyfin/config:/config
- /media:/media
restart: unless-stopped
devices:
- /dev/dri:/dev/dri
ports:
- 8096:8096
```
::tip
✨ Add the Watchtower label to automate updates:
```yaml [compose.yaml]
services:
jellyfin:
#...
labels:
- com.centurylinklabs.watchtower.enable=true
```
::
Find your PUID and GUID by running:
```bash [Terminal]
id username
```
Fill in your `.env` file with the retrieved values, for example:
```properties [.env]
PUID=1000
GUID=1000
```
Deploy the stack. The local interface is available at `http://yourserverip:8096`.
::note
The `/dev/dri` device is only needed for hardware-accelerated transcoding on Intel/AMD GPUs. Remove it if your server doesn't have one, or adapt it for an NVIDIA GPU following [linuxserver.io's documentation](https://docs.linuxserver.io/images/docker-jellyfin/#hardware-acceleration).
::
## Configure Jellyfin
On first visit, Jellyfin walks you through a setup wizard:
- Choose a display language and create your admin account.
- Add a media library, pointing to `/media/movies` for movies and `/media/tvseries` for TV shows.
- (Optional) Enable hardware acceleration in _Dashboard > Playback_ if you have a compatible GPU.
And that's it! Add your media to `/media/movies` and `/media/tvseries` on your server, then install the Jellyfin app on your devices to watch locally or remotely.
::note
If your media is stored on a network disk (e.g. NAS or external hard drive over the network), refer to the [Samba mount guide](/general/networking/samba) so Jellyfin can access it.
::
## Expose Jellyfin with Swag
To access Jellyfin outside your local network, we'll expose it through Swag.
::note
We assume you have the subdomain `jellyfin.mydomain.com` with a `CNAME` pointing to `mydomain.com` in your [DNS zone](/general/networking/dns). And of course, [unless you use Cloudflare Zero Trust](/serveex/security/cloudflare), your box's port `443` must be forwarded to your server's port `443` in [NAT rules](/general/networking/nat).
::
Go to Dockge and edit SWAG's compose file by adding Jellyfin's network:
```yaml [compose.yaml]
services:
swag:
container_name: # ...
# ...
networks: # Attach container to custom network
# ...
- jellyfin # Name of the declared network
networks: # Define the custom network
# ...
jellyfin: # Declared network name
name: jellyfin_default # Actual external network name
external: true # Marks it as externally defined
```
Redeploy the stack and wait for SWAG to be fully operational.
::note
Here we assume the Jellyfin network name is `jellyfin_default`. You can check the connection by visiting SWAG's dashboard at `http://yourserverip:81`.
::
In the Swag folders, create the file `jellyfin.subdomain.conf`:
::tip{icon=""}
✨ __Tip:__ Use [File Browser](/serveex/files/file-browser) to navigate and edit files instead of using terminal commands.
::
```bash [Terminal]
sudo nano /docker/swag/config/nginx/proxy-confs/jellyfin.subdomain.conf
```
Paste the following configuration:
```nginx [jellyfin.subdomain.conf]
## Version 2023/12/19
server {
listen 443 ssl;
listen [::]:443 ssl;
server_name jellyfin.*;
include /config/nginx/ssl.conf;
client_max_body_size 0;
# enable for ldap auth (requires ldap-location.conf in the location block)
#include /config/nginx/ldap-server.conf;
# enable for Authelia (requires authelia-location.conf in the location block)
#include /config/nginx/authelia-server.conf;
# enable for Authentik (requires authentik-location.conf in the location block)
#include /config/nginx/authentik-server.conf;
location / {
# enable the next two lines for http auth
#auth_basic "Restricted";
#auth_basic_user_file /config/nginx/.htpasswd;
# enable for ldap auth (requires ldap-server.conf in the server block)
#include /config/nginx/ldap-location.conf;
# enable for Authelia (requires authelia-server.conf in the server block)
#include /config/nginx/authelia-location.conf;
# enable for Authentik (requires authentik-server.conf in the server block)
#include /config/nginx/authentik-location.conf;
include /config/nginx/proxy.conf;
include /config/nginx/resolver.conf;
set $upstream_app jellyfin;
set $upstream_port 8096;
set $upstream_proto http;
proxy_pass $upstream_proto://$upstream_app:$upstream_port;
}
}
```
Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit.
Wait a few minutes, then open `https://jellyfin.mydomain.com` in your browser.
::caution
__If it fails:__ check your firewall rules.
::
::tip{icon=""}
✨ __Tip:__ You can protect this app with [TinyAuth](/serveex/security/tinyauth) and [Pocket ID](/serveex/security/pocket-id) using the reverse-proxy pattern from the TinyAuth guide, or with Authentik by opening `jellyfin.subdomain.conf` and uncommenting `include /config/nginx/authentik-server.conf;`{lang=nginx} and `include /config/nginx/authentik-location.conf;`{lang=nginx}. Don't forget to [create an application and provider in Authentik](/serveex/advanced/authentik#protecting-an-app-via-reverse-proxy).
::
And you're done!
content/en/3.serveex/5.media/2.qbittorrent.md
+5 -5
View File
@@ -41,7 +41,7 @@ root
│ ├── compose.yaml
│ └── .env
│
└── media #linked to Plex and Qbittorrent
└── media #linked to Jellyfin and Qbittorrent
├── downloads #generic downloads, selected in settings
├── movies #used for downloading movies
└── tvseries #used for downloading TV shows
@@ -209,13 +209,13 @@ Change your username and password in the "webui" settings.
You're done! In Qbittorrent settings, under "Downloads", set `/media/downloads` as the default folder.
When adding a download, remember to select the proper directory so Plex can sync correctly (`/media/movies` or `/media/tvseries`). You can also automate this with categories and folders.
When adding a download, remember to select the proper directory so Jellyfin can sync correctly (`/media/movies` or `/media/tvseries`). You can also automate this with categories and folders.
## Exposing the Web UI
::warning
Qbittorrent does not support multi-factor authentication. Exposing it to the internet may put your system at risk. Only do this if you use MFA via [Authentik](/serveex/security/authentik/). Otherwise, don’t expose it with SWAG—use a VPN like [Wireguard](/serveex/security/wireguard) instead.
Qbittorrent does not support multi-factor authentication. Exposing it to the internet may put your system at risk. Only do this if you use MFA via [Authentik](/serveex/advanced/authentik/). Otherwise, don’t expose it with SWAG. Use a VPN like [Wireguard](/serveex/security/wireguard) instead.
::
To start downloads from outside your home, without a VPN, you can expose the Qbittorrent web UI.
@@ -315,12 +315,12 @@ server {
```
::tip
✨ You can secure this app with Authentik by uncommenting the `authentik-server.conf` and `authentik-location.conf` lines. Don’t forget to [create an app and provider in Authentik](/serveex/security/authentik#protecting-an-app-via-reverse-proxy).
✨ You can secure this app with [TinyAuth](/serveex/security/tinyauth) and [Pocket ID](/serveex/security/pocket-id) using the reverse-proxy pattern from the TinyAuth guide, or with Authentik by uncommenting the `authentik-server.conf` and `authentik-location.conf` lines. Don’t forget to [create an app and provider in Authentik](/serveex/advanced/authentik#protecting-an-app-via-reverse-proxy).
::
Press :kbd{value="Ctrl+O"}, then :kbd{value="Enter"} to save, and :kbd{value="Ctrl+X"} to exit.
Wait a few minutes, then go to `https://seedbox.mydomain.com`—you should land on the Qbittorrent interface.
Wait a few minutes, then go to `https://seedbox.mydomain.com`. You should land on the Qbittorrent interface.
And that’s it! You now have a ready-to-use media center.
content/en/3.serveex/5.media/3.servarr.md
+63 -83
View File
@@ -1,6 +1,6 @@
---
title: Automation
description: Automate media downloads with the Servarr stack — Radarr, Sonarr, Bazarr, Prowlarr, and Overseerr for movies and TV shows.
description: Automate media downloads with the Servarr stack, Radarr, Sonarr, Bazarr, Prowlarr, and Seerr, for movies and TV shows.
---
@@ -10,13 +10,13 @@ description: Automate media downloads with the Servarr stack — Radarr, Sonarr,
::note
🎯 __Goals:__
Automate movie and TV show downloads using Radarr, Sonarr, Bazarr, Prowlarr, and Overseerr.
Automate movie and TV show downloads using Radarr, Sonarr, Bazarr, Prowlarr, and Seerr.
::
[Servarr](https://wiki.servarr.com/) is a suite of applications developed to automate the downloading, updating, and management of media. Here, we'll focus on movies and TV shows with the goal of:
- Selecting a movie from a catalog through a web interface.
- Sitting back and enjoying it on Plex a few minutes later.
- Sitting back and enjoying it on Jellyfin a few minutes later.
Simple.
@@ -33,11 +33,8 @@ Folder structure:
```text [Directory tree]
root
├── docker
│ ├── plex
│ ├── jellyfin
│ │ ├── compose.yml
│ │ ├── config
│ │ └── transcode
│ ├── tautulli
│ │ └── config
│ ├── sonarr
│ │ └── config
@@ -47,7 +44,7 @@ root
│ │ └── config
│ ├── prowlarr
│ │ └── config
│ └── overseerr
│ └── seerr
│ └── config
└── media
├── downloads
@@ -60,53 +57,33 @@ root
__Warning:__ Make sure to follow this file structure carefully, especially the `media` folder. This folder must be mounted **exactly the same way** in both the _Qbittorrent_ compose file (`/your/path/media:/media`) and the _arr_ applications.
If not, the _arr_ apps may not recognize the path provided by Qbittorrent and will fail to create _hardlinks_.
Without hardlinks, the _arr_ apps will copy the files instead—**doubling the space used** on your storage.
Without hardlinks, the _arr_ apps will copy the files instead, **doubling the space used** on your storage.
::
Open Docker and your `plex` stack. Modify the compose file as follows:
Open Docker and your `jellyfin` stack. Modify the compose file as follows:
```yaml [compose.yaml]
---
services:
linuxserver_plex:
image: ghcr.io/linuxserver/plex:latest
container_name: plex
network_mode: host
jellyfin:
image: lscr.io/linuxserver/jellyfin:latest
container_name: jellyfin
environment:
- PUID=${PUID}
- PGID=${PGID}
- TZ=Europe/Paris
- VERSION=docker
- PLEX_CLAIM= #optional
volumes:
- /docker/plex/config:/config
- /docker/plex/transcode:/transcode #optional
- /docker/jellyfin/config:/config
- ${MEDIA_PATH}:/media
labels:
- com.centurylinklabs.watchtower.enable=true
restart: unless-stopped
mem_limit: 4096m
mem_reservation: 2048m
devices:
- /dev/dri:/dev/dri
tautulli:
image: lscr.io/linuxserver/tautulli:latest
container_name: tautulli
environment:
- TZ=Europe/Paris
volumes:
- /docker/tautulli/config:/config
ports:
- 8181:8181
restart: unless-stopped
- 8096:8096
sonarr:
image: lscr.io/linuxserver/sonarr:latest
container_name: sonarr
@@ -157,21 +134,16 @@ services:
- 9696:9696
restart: unless-stopped
overseerr:
image: lscr.io/linuxserver/overseerr:latest
container_name: overseerr
dns:
- 1.1.1.1
- 8.8.8.8
seerr:
image: ghcr.io/seerr-team/seerr:latest
container_name: seerr
environment:
- PUID=${PUID}
- PGID=${PGID}
- LOG_LEVEL=info
- TZ=Europe/Paris
volumes:
- /docker/overseerr/config:/config
- /docker/seerr/config:/app/config
ports:
- 5055:5055
@@ -200,13 +172,7 @@ services:
```yaml [compose.yaml]
services:
plex:
#...
labels:
- com.centurylinklabs.watchtower.enable=true
tautulli:
jellyfin:
#...
labels:
@@ -228,6 +194,15 @@ MEDIA_PATH=
| `GUID` | Same as above | `1000` |
| `MEDIA_PATH` | Path to your media folder, here: `/media`. It must match the one used by Qbittorrent. | `/media` |
::note
Unlike the other containers here, Seerr's image doesn't use `PUID`/`PGID`; it always runs as UID `1000`. Make sure `/docker/seerr/config` is owned by that user, or Seerr won't be able to write to it:
```bash [Terminal]
sudo chown -R 1000:1000 /docker/seerr/config
```
::
Deploy the stack.
### Configure Radarr
@@ -268,16 +243,18 @@ In *Settings > Download Clients*, add Qbittorrent.
- Click *Test*.
- If successful, click *Save*.
##### Connect to Plex
##### Connect to Jellyfin
Go to *Settings > Connect*, add a new connection and choose *Plex Media Server*.
First, get an API key from Jellyfin: log in as admin, go to *Dashboard > Advanced > API Keys*, and add a new one.
- Use `plex` or your server IP for *Host*.
- Port: `32400`
- Click the blue "authenticate with Plex.tv" button and log into Plex.
Then, in Radarr, go to *Settings > Connect*, add a new connection and choose *Jellyfin*.
- Use `jellyfin` or your server IP for *Host*.
- Port: `8096`
- Paste the API key you generated.
- Press *Test*, then *Save* if successful.
##### Get API Key for Prowlarr and Overseerr
##### Get API Key for Prowlarr and Seerr
- Go to *Settings > General* and copy your *API Key* for later use.
@@ -358,13 +335,11 @@ Go to *Settings > General* and create a username and password using *forms login
Repeat the same steps for Radarr.
### Configuring Overseerr
### Configuring Seerr
[Overseerr](https://overseerr.dev/) is an app that lets you browse a movie catalog and send requests to Sonarr and Radarr. Just browse movies or series, click *Request*, and the media will automatically be downloaded according to your Radarr or Sonarr settings. If the title hasn’t been released yet, it will be downloaded automatically when available. This way, episodes of a series appear in Plex without any manual intervention.
[Seerr](https://seerr.dev/) (the unified successor of Overseerr and Jellyseerr) is an app that lets you browse a movie catalog and send requests to Sonarr and Radarr. Just browse movies or series, click *Request*, and the media will automatically be downloaded according to your Radarr or Sonarr settings. If the title hasn’t been released yet, it will be downloaded automatically when available. This way, episodes of a series appear in Jellyfin without any manual intervention.
![Overseerr](/img/serveex/overseerr.webp)
Go to `http://yourserverip:5055` and log in with your Plex account.
Go to `http://yourserverip:5055`, select *Jellyfin* as your media server, and sign in with your Jellyfin admin account.
::caution
@@ -385,7 +360,7 @@ When prompted, add a Radarr server:
If the test succeeds, continue filling in the fields:
- __Quality Profile:__ the one you configured (e.g., `any`)
- __Root Folder:__ the Plex folder. In our examples: `/media/movies`
- __Root Folder:__ the Jellyfin folder. In our examples: `/media/movies`
- __Minimum Availability:__ `Announced`. This allows requesting unreleased content and downloads it upon release.
- Check all 3 boxes at the bottom.
- Save and continue.
@@ -402,46 +377,51 @@ Now do the same for Sonarr:
If the test succeeds, continue filling in the fields:
- __Quality Profile:__ the one you configured (e.g., `any`)
- __Root Folder:__ the Plex folder. In our examples: `/media/tvseries`
- __Root Folder:__ the Jellyfin folder. In our examples: `/media/tvseries`
- __Language Profile:__ `Deprecated`
- Check all 4 boxes at the bottom.
- Save and continue.
And that’s it! Just request a movie or series, then check in qBittorrent or Radarr/Sonarr. Within a few minutes, your media will be available on Plex!
And that’s it! Just request a movie or series, then check in qBittorrent or Radarr/Sonarr. Within a few minutes, your media will be available on Jellyfin!
## Exposing Overseerr with SWAG
## Exposing Seerr with SWAG
It can be useful to expose Overseerr if you want to send requests from outside your network without a VPN, or if you've shared your Plex library with others and want them to have Overseerr access.
It can be useful to expose Seerr if you want to send requests from outside your network without a VPN, or if you've shared your Jellyfin library with others and want them to have Seerr access.
::warning
Seerr has no built-in two-factor authentication. Only expose it if you're using a secure authentication solution like [TinyAuth](/serveex/security/tinyauth) with [Pocket ID](/serveex/security/pocket-id), or [Authentik](/serveex/advanced/authentik). Otherwise, don't expose it with SWAG, use a VPN like [Wireguard](/serveex/security/wireguard) instead.
::
::note
We assume you have the subdomain `films.mydomain.com` with a `CNAME` pointing to `films.fr` in your [DNS zone](/general/networking/dns). And that [unless you’re using Cloudflare Zero Trust](/serveex/security/cloudflare), port `443` on your router is forwarded to port `443` on your server via [NAT rules](/general/networking/nat).
::
Go to Dockge, edit the SWAG compose file, and add the Overseerr network, which is the same as Plex (since it’s in the Plex stack):
Go to Dockge, edit the SWAG compose file, and add the Seerr network, which is the same as Jellyfin (since it’s in the Jellyfin stack):
```yaml [compose.yaml]
services:
swag:
container_name: # ...
# ...
networks: # Connects the container to a custom network
networks: # Connects the container to a custom network
# ...
- plex # Name of the network declared in the stack
- jellyfin # Name of the network declared in the stack
networks: # Defines the custom network
networks: # Defines the custom network
# ...
plex: # Name of the declared network
name: plex_default # Actual name of the external network
external: true # Indicates it’s an external network
jellyfin: # Name of the declared network
name: jellyfin_default # Actual name of the external network
external: true # Indicates it’s an external network
```
Restart the stack by clicking “Deploy” and wait until SWAG is fully operational.
::note
Here we assume the Tautulli network is named `plex_default`. You can verify the connection works by visiting the SWAG dashboard at `http://yourserverip:81`.
Here we assume the Jellyfin network is named `jellyfin_default`. You can verify the connection works by visiting the SWAG dashboard at `http://yourserverip:81`.
::
Create and edit the file `films.subdomain.conf`:
@@ -458,8 +438,8 @@ Paste the following:
```nginx [films.subdomain.conf]
## Version 2024/07/16
# make sure that your overseerr container is named overseerr
# make sure that your dns has a cname set for overseerr
# make sure that your seerr container is named seerr
# make sure that your dns has a cname set for seerr
server {
listen 443 ssl;
@@ -496,17 +476,17 @@ server {
include /config/nginx/proxy.conf;
include /config/nginx/resolver.conf;
set $upstream_app overseerr;
set $upstream_app seerr;
set $upstream_port 5055;
set $upstream_proto http;
proxy_pass $upstream_proto://$upstream_app:$upstream_port;
}
location ~ (/overseerr)?/api {
location ~ (/seerr)?/api {
include /config/nginx/proxy.conf;
include /config/nginx/resolver.conf;
set $upstream_app overseerr;
set $upstream_app seerr;
set $upstream_port 5055;
set $upstream_proto http;
proxy_pass $upstream_proto://$upstream_app:$upstream_port;
@@ -524,4 +504,4 @@ Wait a few minutes, then visit `http://films.mydomain.com` in your browser.
__If it fails:__ check your firewall rules.
::
And there you go, Overseerr is now publicly accessible!
And there you go, Seerr is now publicly accessible!