Linux Troubleshooting Guide and FAQ

Emby Server does not restart from the web interface:

Emby on Linux does not have the built-in capability to restart itself. So to restart Emby uses a helper script. The helper script named restart.sh can be found on most distributions at /usr/lib/emby-server. The script can only restart Emby if it was started by a service manager program such as systemctl, service, or invoke-rc.d. If for some reason the helper script does not successfully restart Emby for you, please check the following:

• Ensure helper script is executable.
• Ensure Emby was started via a service manager.
• Ensure permissions of /etc/sudoers.d/emby are 0640
• Ensure whatever user is running emby-server is part of the emby group (usermod -a -G emby $USER_NAME)
• Ensure /etc/sudoers permissions is 0640

####Example of troubleshooting restart on a distribution using systemd:

1. sudo systemctl status emby-server - Get PID.
2. Hit restart on web interface
3. sudo systemctl status emby-server - Get PID.

If PIDs differ restart was successful. Otherwise, check the following:

1. ls -la /usr/lib/restart.sh - ensure it is executable.
2. ps -aux | grep emby - Take note of PID
3. su - emby -c "/usr/lib/emby-server/restart.sh" - if you running emby-server as another user other than emby, please adjust command appropriately.
4. ps -aux | grep emby - Take note of PID

If PIDs differ restart worked.

Will you support Intel QSV on Linux:

Intel QSV on Linux is not widely supported. Yes, Intel has made the media sdk opensource, but it is only available for specific distros and kerenls. It would not be fruitful at this time for the Emby development team to dedicate any time on getting QSV working on Linux. Once Intel's media sdk is widely available the decision will be revisited.

What distros and kernel version are supported by Intel QSV:

At the time of writing, Intel officially supports QSV on SLES 12 and Centos 7.1.

If I want Intel QSV no matter what, what can I do:

Follow the guidelines from Intel on installing the media sdk on one of the supported platforms. Then follow the ffmpeg compiling guide to enable QSV.

I can not add media: