Containers
Jellyfin

Jellyfin

Jellyfin

Jellyfin is an open-source self-hosted media server.

Configuration

Image

To use jellyfin, it needs to be included in your generated image. Update your build configuration to include it.

.config/my-server-build
{
  "containers": [
    "jellyfin"
  ]
}

Service

A systemd container unit for jellyfin has been included in automatos-server. This container unit file serves as a baseline and requires additional customizations from the user to run jellyfin successfully.

etc/containers/systemd/jellyfin.container
[Unit]
Description=Container service for Jellyfin
Requires=network-online.target nss-lookup.target jellyfin-network.service
After=network-online.target nss-lookup.target jellyfin-network.service

[Container]
ContainerName=%p
Image=docker.io/jellyfin/%p:latest
Volume=${CONTAINER_PATH}/config:/config:Z
Volume=${CONTAINER_PATH}/cache:/cache:Z
PublishPort=${WEB_PORT}:8096
Tmpfs=/transcode
User=${UID}
Group=${GID}
Network=jellyfin-network
AutoUpdate=registry

[Service]
EnvironmentFile=/etc/environment
ExecCondition=/usr/bin/test -d "${CONTAINER_PATH}/config"
ExecCondition=/usr/bin/test -d "${CONTAINER_PATH}/cache"
Restart=on-failure

[Install]
WantedBy=default.target

Important

This container definition is still a little too opinionated. It assumes the user will have a device for hardware-accelerated encoding. It also makes assumptions about networking. In the future, these parameters may be removed and demonstrated below as customizations.

etc/containers/systemd/jellyfin.network
[Network]
NetworkName=%N
Subnet=172.16.203.0/24
IPv6=true

Customizations

Environment Variables

The following are some of the environment variables that can be used to configure the jellyfin container. The values provided are notional and can be changed to suit your needs.

/etc/containers/systemd/jellyfin.container.d/01-variables.conf
[Container]
Environment=GID=1000
Environment=JELLYFIN_PublishedServerUrl=https://proxy.to.jellyfin
Environment=TZ=Etc/Utc
Environment=UID=1000

[Service]
Environment=CONTAINER_PATH=/var/path/to/jellyfin/volumes
Environment=WEB_PORT=8096

Volumes

The following are examples of volumes that could be specified for jellyin.

/etc/containers/systemd/jellyfin.container.d/02-volumes.conf
[Container]
Volume=/path/to/movies:/media/movies:z,rw,rslave,rbind
Volume=/path/to/tv:/media/tv:z,rw,rslave,rbind

Devices

/etc/containers/systemd/jellyfin.container.d/03-devices.conf
[Container]
AddDevice=/dev/dri

References

Last updated on