[GUIDE] Jellyfin container/docker 2022

[Moogle Stiltzkin]

The original guide was here (back when i was trying to learn and figure things out. So probably ignore the thread. it's just for archival purpose)
viewtopic.php?t=155771#p757969


If you want an alternative guide, drauk posted one method but using portainer
https://www.reddit.com/r/qnap/comments/ ... der_setup/

and here
https://www.reddit.com/r/jellyfin/comme ... container/

linuxserver/jellyfin

Jellyfin is a Free Software Media System that puts you in control of managing and streaming your media. It is an alternative to the proprietary Emby and Plex, to provide media from a dedicated server to end-user devices via multiple apps. Jellyfin is descended from Emby's 3.5.2 release and ported to the .NET Core framework to enable full cross-platform support. There are no strings attached, no premium licenses or features, and no hidden agendas: just a team who want to build something better and work together to achieve it.

https://hub.docker.com/r/linuxserver/jellyfin

https://jellyfin.org/



demo



Jellyfin vs. Plex: Side-by-Side Comparison
https://www.wundertech.net/jellyfin-vs- ... omparison/
https://www.reddit.com/r/selfhosted/com ... june_2022/
https://www.reddit.com/r/selfhosted/com ... _jellyfin/
https://www.slant.co/versus/8106/35783/ ... s_jellyfin

Jellyfin is Better than Plex and Emby | How to Use Jellyfin to Organize Your Media
https://www.youtube.com/watch?v=94J0CiJmvws

notes: i've personally tried plex, emby and jellyfin. Out of these i probably like jellyfin the most. and after checking other reviews, people recommend to me to use jellyfin out of the 3 because not interested in paying for a plex pass, also want to run this as a docker app. functionally it works fine, so i have no reason to use the other 2 alternatives.

my main gripe about plex is most of the nice features are hidden behind a paywall e.g. graphics card transcoding. But jellyfin offers this feature for free with no paywall, and as such guess which i rather use not hating on paid solutions, but if the alternative is free and almost or just as good .... people haven't caught on yet, hence why i have to point it out

Ok now i know more about containers, so here is my updated guide how to setup Jellfin docker app using container station (i used the beta v3 cs)


step1:

In container station, click explore. Then use following below and install that. There is another which is jellyfin/jellyfin, but the one i used for my guide and personal use is the one below.

Code: Select all

linuxserver/jellyfin

https://hub.docker.com/r/linuxserver/jellyfin


select the latest.


step2:

edit the install settings.


in storage for the /config, this i created a new folder and used a "bind mount host path" to /Container/linuxserver-jellyfin
The reason for this is, so when updating the app, the config will persist. Permissions is Read/write (r/w)

Next is to add the volumes where your media reside. Mine for example

path: /Storage/Videos
container: storage1

path: /Storage2/Videos
container: storage2

also using "bind mount host path". But this time i put to R/O (read only)

Basically what this means is, i only allow jellyfin to r/w config to that config folder. And only allow read for the media folder (cauz i don't want it to be accidentally deleting, editing or adding anything to the media folder whatsoever)



In environment, add a label "TZ" then value your timezone e.g. "America/New_York" without quotes.
https://en.wikipedia.org/wiki/List_of_t ... time_zones


Next go to networks. Here you can either opt to use the default, or set to bridge mode then set a static ip. I just left it default. But you can do the other change if you want to (which most users recommend)


User PUID / Group Identifiers PGID. this part of the setup i skipped. this setting is to tighten down the security so that jellyfin does not run as a root user. if you want to do this, you can check the documentation at the link below that explains it. in my original attempt i did try setting up this way. but this time around i did not bother. i'm not exposing nas online, and only using for local lan

User / Group Identifiers

When using volumes (-v flags) permissions issues can arise between the host OS and the container, we avoid this issue by allowing you to specify the user PUID and group PGID.

Ensure any volume directories on the host are owned by the same user you specify and any permissions issues will vanish like magic.

In this instance PUID=1000 and PGID=1000, to find yours use id user as below:

$ id username
uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

https://github.com/linuxserver/docker-jellyfin/
https://hub.docker.com/r/linuxserver/jellyfin


once all your settings is done, then install.

step3:

once the install is done, get your url from the docker app, then open that url in a browser e.g. mine was

Code: Select all

http:// my nas lan ip:49162/

then just go through the web setup steps.

to add your media, just browse to your media folder (it will detect this because you added it in docker settings earlieri e.g. my example was the storage1 and storage2).


If you have anime, i recommend adding the anime anidb plugin for the meta data


Enjoy


*update

the reason why the guide is labelled incomplete, is because the part for setting the ffmpeg to work is not solved in my guide. however someone may have found a solution, though i haven't tested it yet myself
viewtopic.php?f=177&t=167351#p824383

however even if you did not setup the ffmpeg in settings, it will still work albeit without the ffmpeg (which is not ideal). You however need to make sure that the default setting is the following below and not simply leave it empty

Code: Select all

/usr/lib/jellyfin-ffmpeg/ffmpeg

[Moogle Stiltzkin]

testing jellyfin to an android smartphone

install this app (it doesn't get a 5 star rating, but you need this app to easily connect to the jellfin server, and to also browse your media. I highly recommend to use the open media using an external media player such as mx player rather than the default)
https://play.google.com/store/apps/deta ... fin.mobile

then click quick connect. you will see numbers. then go to your jellyfin admin page, click quickconnect then insert the numbers shown from the android device. click authorize. now your android will be connected to jellyfin.


during playback the stats say live transcoding started. I tested with a TS-877 QNAP NAS, so it was more than able to do live transcoding without any stutter for 1080p content.


based on my testing, i recommend in the mobile app to opt to use external media player MX player (highly recommended). And set that up to use SW mode with the codecpack installed for it.



they also have another app but for android tv
https://play.google.com/store/apps/deta ... .androidtv


so if you want to connect from tv to jellyfin qnap nas, use that app instead. then for convenience, use the quick connect.



they even have a desktop client. it's nice it gives me that netflix type of ui experience for browsing media, but it doesn't to offer the option to open the media in an external media player like the mobile app version did (cause i rather watch using mpc-hc on desktop)
https://jellyfin.org/

[Moogle Stiltzkin]

i tried to fix, but couldn't get this to work

one ammendment for this guide (discovered during troubleshoot)

in admin settings under playback ffmpeg path, noticed this did not point to any actual ffmpeg. so you have to fix that.

the solution i came up with is to install ffmpeg qpkg
https://www.myqnap.org/product/ffmpeg-static/


the location for it is

/opt/ffmpeg

so you need to point path to that location somehow (i couldn't get this to work fyi)


so now, i have to reinstall jellyfin using the "recreate". This keeps your previous settings, but allows you to edit them, which is what we need to do. Because now under advance, you can then make the ammendment.

i'm still figuring out a solution to this. but if you don't do this fix, the jellyfin server will run with errors and not be optimal.


so until that gets figured out, just make sure the ffmpeg path is the default below *don't simply leave blank

Code: Select all

/usr/lib/jellyfin-ffmpeg/ffmpeg

latest ffmpeg can be found here
https://johnvansickle.com/ffmpeg/

but i feel that installing the qpkg version is the simplest.

the problem though is jellyfin can't accept the pathing to the ffmpeg location in opt.

i see some users also encountered this issue for setting up ffmpeg for jellyfin over here
viewtopic.php?f=177&t=167351#p824383


i tried creating a folder in container, putting the ffmpeg in there, then add to the jellyfin volume location. It allows me now to browse to there, yet it still says it could not find it. No idea why


still searching for an answer
https://www.reddit.com/r/jellyfin/comme ... ker_image/



another possible solution is try this other app which is a qpkg (i'm assuming he has dealt with this ffmpeg issue in his package somehow, seeing as he compiled it specifically to run on a QNAP nas). i'm not familiar with the dev, so dyor before installing qpkgs outside of the default qnap appcenter (i take no responsibility if something is off when installing third party qpkgs from unknown sources). Fyi i did not try this qpkg app myself.

https://github.com/pdulvp/jellyfin-qnap



*update

basically same issue like this guy
https://www.reddit.com/r/jellyfin/comme ... om_ffmpeg/

[Moogle Stiltzkin]

Just an update.

I've switched to using docker compose. highly recommend following drauk's guide

https://www.reddit.com/r/qnap/comments/ ... der_setup/


i go to portainer, create custom template using the editted docker compose drauk posted, then deploy it.

[Moogle Stiltzkin]

*update

i've switch to installing docker using docker compose with portainer custom template and deploying from there.

this is my modified docker compose

Code: Select all

---
version: "2.1"
services:
  jellyfin:
    image: lscr.io/linuxserver/jellyfin:latest
    container_name: jellyfin
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/London
      - JELLYFIN_PublishedServerUrl=192.168.0.210 #optional
    volumes:
      - /share/Container/jellyfin:/config
      - /share/Storage/Videos:/data/media1
      - /share/Storage2/Videos:/data/media2
    ports:
      - 8096:8096
      - 8920:8920 #optional
      - 7359:7359/udp #optional
      - 1900:1900/udp #optional
    restart: unless-stopped

some explanation for some of these settings. highlighted in red, edit accordingly to your own path


this is the persistent storage for your config. If you want to backup your jellyfin, MAKE SURE u set this, then backup this location to a separate storage device

- /share/Container/jellyfin:/config

This part has left and right sides with the : in between. The left part is the location where your video content is. The right part is the label that will show in jellyfin for browsing where your media is located. If you don't specify your media locations, jellyfin won't be able to let you add these media locations to scan into jellyfin.

- /share/Storage/Videos:/data/media1

This will be the port to access the jellyfin. so the url will be http:// your nas ip :8096

8096

this you modify to your own timezone. refer to here
https://en.wikipedia.org/wiki/List_of_t ... time_zones

- TZ=Europe/London

[Moogle Stiltzkin]

troubleshoot, if u see

Code: Select all

[2021-12-13 11:44:41.258 -06:00] [WRN] [10] Microsoft.EntityFrameworkCore.Model.Validation: The entity type '"ItemDisplayPreferences"' is configured to use schema '"jellyfin"', but SQLite does not support schemas. This configuration will be ignored by the SQLite provider.

in logs, you can ignore

https://github.com/jellyfin/jellyfin/issues/6989




*update

after further testing, jellyfin seems to work for me.

I can playback from android mobile using mxplayer (which is configured with the ffmpeg software codec) and am able to fast forward without any lag.

Jellyfin can scan all my video media, and update automatically any new content to the jellyfin overlay for browsing the content.

So as far as i'm concerned it works.



For testing if the jellyfin points to it's own ffmpeg codec, and for hardware acceleration, these things i did not delve in. You will have to investigate further on your own on this matter. But if you do figure anything out, plz do share back

[Moogle Stiltzkin]

i changed my docker compose to the following after adding traefik (i'm not doing remote fyi). i don't think it's 100% correct, but it works. i tested it myself.

Code: Select all

---
version: "2.1"
services:
  jellyfin:
    image: lscr.io/linuxserver/jellyfin:latest
    container_name: jellyfin
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/London
      - JELLYFIN_PublishedServerUrl=192.168.0.210 #optional
    volumes:
      - /share/Container/jellyfin:/config
      - /share/Storage/Videos:/data/media1
      - /share/Storage2/Videos:/data/media2
    
    labels:
      # Enable this container to be mapped by traefik
      # For more information, see: https://docs.traefik.io/providers/docker/#exposedbydefault
      - traefik.enable=true
      # Define the network that should be used
      - traefik.docker.network=proxy
      # URL to reach this container
      - traefik.http.routers.jellyfin.rule=Host("jellyfin.docker.lan")
      # Activation of TLS
      - traefik.http.routers.jellyfin.tls=true
      # If port is different than 80, use the following service:
      - "traefik.http.services.jellyfin.loadbalancer.server.port=8096"
      
    networks:
      - proxy        
 
    ports:
      - 8096:8096
      - 8920:8920 #optional
      - 7359:7359/udp #optional
     # - 1900:1900/udp #optional
    restart: unless-stopped
    
networks:
  proxy:
    external: true
    

if you opt for traefik, you need to set that up yourself using another guide.

I sort of made a guide for traefik (but mine is only for local homelabs) but i wouldn't recommend it because i'm new to it. But if you are curious you can take a look
viewtopic.php?f=45&t=169043


after implementing traefik for my jellyfin, now to access i go to

Code: Select all

https://jellyfin.docker.lan/

also browsing the web interface, it feels much more smoother

[maxl1]

Hello,

I managed to run jellyfin with hardware acceleration on my TS-253A. The main struggle was to get access to /dev/dri with root privileges and here is how I did it:

1) Prepare folders
- Create a folder called jellyfin (e.g. /Public/jellyfin)
- Create two folders 'cache' and 'config' within this folder (e.g. /Public/jellyfin/cache and /Public/jellyfin/config)

2) Create container
- Go to Container Station and click on explore
- Search for jellyfin/jellyfin and deploy the latest version of it
- Go to advanced settings:
- In networks, change network mode to host
- In environment, add three variables:
Variable: PUID, Value: 1000
Variable: PGID, Value: 1000
Variable: TZ, Value: 'yourTimezone' (e.g. Europe/London)
- In storage, add two volumes
Volume: cache, Container: /Public/jellyfin/cache
Volume: config, Container: /Public/jellyfin/config
- In storage, add bind mount host path
Host: 'path to your media library', Container: 'name shown in jellyfin'; RW access
- In runtime, activate privileged mode and add direct rendering infrastructure with RW access
- Click on apply and finish the installation
- Start jellyfin

3) Check official jellyfin documentation
The following part is well described in the official documentation and depends on your GPU. Therefore, I will just post the link to the documentation.
As you need access to your running container, please copy the docker ID from Container Station and access jellyfin container by SSH (using PuTTY, for example). Doing so also allows you to install any packages needed for hardware acceleration:

- Log in to your NAS with PuTTY as admin
- Quit the QNAP menu (if present) and type:

Code: Select all

docker exec -u root -i -t 'docker ID for jellyfin' /bin/bash

- Follow the instructions for Linux host given here (choose the right GPU):

https://jellyfin.org/docs/general/admin ... eleration/

4) Activate hardware acceleration on the jellyfin dashboard


Enjoy hardware acceleration


Special credits go to SPANdotCOM for his video and of course to you, Moogle:

https://youtu.be/SMe02jARF64?si=w7LGjajEe_dbpeS_

[Moogle Stiltzkin]

...

ty max for sharing


also i want to share a tip i just recently learned.

after i had to re-do my raid5 array (replace a drive and raid failed to rebuild. don't worry i had a backup ), i noticed that jellyfin no longer worked.

The reason apparently was that the jellyfin storage area had changed. so i just modified the jellyfin docker template with the new storage location, reinstalled and it worked again

so for anyone who also ran into a similar situation and found that jellyfin or perhaps other dockers didn't work, just check that the jellyfin docker pathing for storage is still correct or not, or whether you have to change it to the new one.