dshap/jellyfin repository overview

⁠Jellyfin video streaming server

Docker image for jellyfin video streaming server.

Container runs as non-root user. This user owns jellyfin process and owns jellyfin files.

To run container next volumes should be mapped:

• folder for configs
• folder for metadata
• folder for media files
• folder to upload files
• logs folder
• backups folder

⁠Installation

⁠Installation from docker image

1. Pull docker image
2. Create user and group to own jellyfin files and to run docker container:

   sudo groupadd -g 1191 jellyfin
   

   Copy

   useradd -u 1191 -g 1191 -M jellyfin
   

   Copy
3. Proceed to configuration

⁠Installation from source

1. Pull project sources from version control system
2. Create user and group to own jellyfin files and to run docker container:

   sudo useradd -r jellyfin
   

   Copy

   sudo groupmod -g 1191 jellyfin
   

   Copy

   sudo usermod -u 1191 jellyfin
   

   Copy
3. Make build executable:

   sudo chmod u+x ./build
   

   Copy
4. Execute build:

   sudo ./build jellyfin
   

   Copy
5. Proceed to configuration

⁠Configuration

1. Obtain configuration files and scripts from the container:

   cd ~
   

   Copy

   mkdir conf
   

   Copy

   sudo chown jellyfin:jellyfin ~/conf
   

   Copy

   sudo docker run \
       --rm \
       -v ~/conf:/export \
       dshap/jellyfin:12.0 export-assets
   

   Copy
2. Create folders for jellyfin files:

   sudo mkdir /jellyfin
   

   Copy

   sudo mkdir /jellyfin/config
   

   Copy

   sudo touch /jellyfin/config/fileNameExcludes
   

   Copy

   sudo touch /jellyfin/config/fileContentExcludes
   

   Copy

   sudo mkdir /jellyfin/data
   

   Copy

   sudo mkdir /jellyfin/media
   

   Copy

   sudo mkdir /jellyfin/media/movies
   

   Copy

   sudo mkdir /jellyfin/media/series
   

   Copy

   sudo mkdir /jellyfin/upload
   

   Copy

   sudo chown -R jellyfin:jellyfin /jellyfin
   

   Copy
3. Create a folder for logs:

   sudo mkdir /var/log/jellyfin
   

   Copy

   sudo chown -R jellyfin:jellyfin /var/log/jellyfin
   

   Copy
4. Create a folder for backups:

   sudo mkdir /var/backups/jellyfin
   

   Copy

   sudo chown -R jellyfin:jellyfin /var/backups/jellyfin
   

   Copy
5. Copy service configuration file:

   sudo cp ~/conf/etc/init.d/jellyfin /etc/init.d
   

   Copy

   sudo chmod a+x /etc/init.d/jellyfin
   

   Copy
6. Copy docker run script:

   sudo cp ~/conf/usr/sbin/jellyfin /usr/sbin
   

   Copy

   sudo chmod a+x /usr/sbin/jellyfin
   

   Copy
7. Copy util script:

   sudo cp ~/conf/usr/bin/jfutil /usr/bin
   

   Copy

   sudo chmod a+x /usr/bin/jfutil
   

   Copy
8. Remove temporary config folder:

   sudo rm -rf ~/conf
   

   Copy
9. Register service:

   sudo update-rc.d jellyfin defaults
   

   Copy
10. Start jellyfin service:

    sudo service jellyfin start
    

    Copy
11. Open jellyfin UI and initialize jellyfin
12. Restart jellyfin service:

    sudo service jellyfin restart
    

    Copy

⁠Management

⁠Service management

sudo service jellyfin (start|stop|status|restart)

⁠Create backup

sudo jfutil backup <filename>

Backup file /var/backups/jellyfin/<filename>.tar.gz will be created.

⁠Restore backup

sudo jfutil restore <filename>

⁠Command line (bash)

sudo jfutil bash

⁠Apache mod_proxy configuration

Jellyfin video streaming server can be located with another web applications. For example, mercurial, bugzilla, wiki etc can be run as docker containers on the same host. In this case apache server can be used to redirect requests to different docker containers.

1. Enable apache mod_proxy:

   sudo a2enmod deflate headers proxy proxy_ajp proxy_balancer proxy_connect proxy_html proxy_http rewrite
   

   Copy
2. Configure proxy:

   <VirtualHost *:80>
       ...
       ProxyPreserveHost On
       <Proxy *>
           Order allow,deny
           Allow from all
       </Proxy>
       ...
   </VirtualHost>
   

   Copy
3. Copy site configuration file:

   sudo cp ~/conf/etc/apache2/sites-available/jellyfin.conf /etc/apache2/sites-available
   

   Copy
4. Enable apache sites:

   sudo a2ensite jellyfin
   

   Copy
5. Restart apache service:

   sudo service apache2 restart
   

   Copy

⁠HOW TO

⁠How to get media directory structure

sudo jfutil show-tree

⁠How to check if uploaded files and folders have valid name and content

sudo jfutil check-files

⁠How to set permit of uploaded files and folders

sudo jfutil set-permit

⁠How to configure valid name and content checks

1. Edit file /jellyfin/config/fileNameExcludes and specify wrong file names in grep format.

   # Check wrong file extensions
   *.png
   *.jfif
   *.avi
   *.mkv
   
   # Check wrong symbols in file names
   *–*
   *—*
   *  *
   *…*
   *!*
   *..*
   *·*
   *"*
   *`*
   *“*
   

   Copy
2. Edit file /jellyfin/config/fileContentExcludes and specify wrong char sequences in nfo files.

   # Check wrong symbols in file content
   –
   —
   …
   "
   ·
   `
   “
   !?
   !!
   ?!
   ??
   

   Copy

⁠How to create cron job for backups

sudo crontab -l | { cat; echo "minute hour * * * /usr/bin/jfutil backup <filename>"; echo ""; } | sudo crontab -