zishuo/embyserver repository overview

⁠Emby Media Server

⁠原汁原味的官方Docker容器用法，只是单纯的进行破解及插件源，内置刮削补丁穿墙方案，改善大陆地区的用户体验，本镜像不用任何插件即可硬件转码和外网播放(小白不懂就多看看教程，不显示硬件转码不要怪镜像的问题，群晖用户请用命令启动WEB界面不能挂载显卡)。另外加入了聊天室功能，便于老司机相互分享资源及交流玩机心得。

⁠感谢老司机 Yukino⁠ 提供持戒dll思路以及其他大佬的破解方案，加上自己对源码的反编译才有了这个算是比较完美的Emby容器镜像。

• Introduction⁠
  • Supported Architectures⁠
  • Supported Tags⁠
  • Issues⁠
• Getting started⁠
  • Installation⁠
  • Upgrade⁠
• DLNA and WoL⁠
• VAAPI⁠
• NVDEC/NVENC⁠
• unRAID⁠
  • Installation⁠

⁠Introduction

Emby Server is a home media server built on top of other popular open source technologies such as Service Stack, jQuery, jQuery mobile, and .NET Core.

It features a REST-based API with built-in documention to facilitate client development. We also have client libraries for our API to enable rapid development.

⁠Supported Tags

• latest: latest stable release
• beta: latest beta release

⁠Issues

Before reporting your issue please try updating Docker to the latest version and check if it resolves the issue. Refer to the Docker installation guide⁠ for instructions.

SELinux users should try disabling SELinux using the command setenforce 0 to see if it resolves the issue.

If the above recommendations do not help then report your issue⁠ along with the following information:

• Output of the docker version and docker info commands
• The docker run command or docker-compose.yml used to start the image. Mask out the sensitive bits.
• Please state if you are using Boot2Docker⁠, VirtualBox⁠, etc.

⁠Getting started

⁠Installation

It is recommended you install directly from the Docker Hub⁠.

docker pull zishuo/embyserver:latest

The new .NET Core version is entirely configured via the command line. The launcher script and configuration files are gone, as well as the in-place update feature. Updates are now retrieved by simply pulling the latest image from the hub.

The container can be run using the following command:

docker run -d \
    --volume /path/to/programdata:/config \ # This is mandatory
    --volume /path/to/share1:/mnt/share1 \ # To mount a first share
    --volume /path/to/share2:/mnt/share2 \ # To mount a second share
    --net=host \ # Needed for DLNA and Wake-on-Lan
    --device /dev/dri:/dev/dri \ # To mount all render nodes for VAAPI/NVDEC/NVENC
    --runtime=nvidia \ # To expose your NVIDIA GPU
    --publish 8096:8096 \ # To expose the HTTP port
    --publish 8920:8920 \ # To expose the HTTPS port
    --env UID=1000 \ # The UID to run emby as (default: 2)
    --env GID=100 \ # The GID to run emby as (default 2)
    --env GIDLIST=100 \ # A comma-separated list of additional GIDs to run emby as (default: 2)
    zishuo/embyserver:latest

Please adapt the UID, GID and GIDLIST values to match the owner of your media files. GIDLIST is also needed to grant access to VAAPI/NVDEC/NVENC render nodes.

⁠Upgrade

The command used to install should also be used to upgrade:

docker pull zishuo/embyserver:latest

⁠DLNA and WoL

The easiest way for DLNA and Wake-on-Lan to work properly is to use the host networking mode. It may work in bridge mode as well with a more advanced configuration.

⁠VAAPI

Note: This applies to amd64 only.

Emby now comes with a VAAPI-enabled ffmpeg out of the box on Intel platforms with HD graphics. For VAAPI to work, emby needs access to a render node, usually /dev/dri/renderD128. On most modern distros, this render node belongs to the video group, others belong to the render group. All you need to do is mount the render node and add the video group GID to the GIDLIST variable as described above.

You can get the video and/or render GIDs using the following command:

getent group video | cut -d: -f3
getent group render | cut -d: -f3

⁠NVDEC/NVENC

Note: This applies to amd64 only.

Emby can also utilize your NVIDIA GPU with a little more work, using the NVIDIA docker runtime. You will need to install the nvidia-container-runtime or the legacy nvidia-docker2 package first depending on your distribution, then restart the docker daemon.

Again, you can get the video and/or render GIDs using the following command and set the GIDLIST variable accordingly:

getent group video | cut -d: -f3
getent group render | cut -d: -f3

⁠unRAID

Please navigate to the Docker settings page on unRAID's Web-UI and under repositories add:

https://github.com/MediaBrowser/Emby.Build/tree/master/unraid-templates/emby

For more information on adding templates to unRAID please visit the unRAID forums⁠.