Go to file

nl6720 92036950d8 Improve systemd units Use the same dependencies and their order in both systemd units. Add additional units of services that kodi uses. Don't use "Requires=", kodi can run without a network connection. Export WINDOWING=x11 in kodi.service to skip the autodetection that /usr/bin/kodi-standalone performs. Give kodi-gbm.service the privileges of input group, this allows removing the kodi user from that group's membership since kodi.service does not need it.	2019-12-04 07:57:36 -05:00
init	Improve systemd units	2019-12-04 07:57:36 -05:00
MIT	Improve systemd units	2019-12-04 07:57:36 -05:00
README.md	Improve systemd units	2019-12-04 07:57:36 -05:00

nl6720 92036950d8 Improve systemd units

Use the same dependencies and their order in both systemd units.
Add additional units of services that kodi uses.
Don't use "Requires=", kodi can run without a network connection.
Export WINDOWING=x11 in kodi.service to skip the autodetection that /usr/bin/kodi-standalone performs.
Give kodi-gbm.service the privileges of input group, this allows removing the kodi user from that group's membership since kodi.service does not need it.

2019-12-04 07:57:36 -05:00

init

Improve systemd units

2019-12-04 07:57:36 -05:00

MIT

Improve systemd units

2019-12-04 07:57:36 -05:00

README.md

Improve systemd units

2019-12-04 07:57:36 -05:00

README.md

kodi-standalone-service

Systemd service units to run Kodi in standalone mode without the need for a DE. Both X11 and GBM are supported (makes little sense to use Wayland in standalone mode).

Installation

Arch Linux

Arch Linux users can find a PKGBUILD in the AUR that will take care of everything. Simply install and use.

Arch ARM

Users of Arch ARM should NOT use this method as the distro package provides analogous functionality.

Other distros

Users of other distros should copy kodi.service and kodi-gbm.service to /usr/lib/systemd/system/ and should create both a kodi user and home directory as follows:

 useradd -c 'kodi user' -u 420 -g kodi -G audio,network,optical,uucp,video \
   -d /var/lib/kodi -s /usr/bin/nologin kodi

 passwd -l kodi > /dev/null

 mkdir /var/lib/kodi
 chown -R kodi:kodi /var/lib/kodi

Note that the kodi user's home directory is /var/lib/kodi/ in this example, NOT /home/kodi/ like a regular user.

Usage

Simply call the requisite service to start, for kodi-x11:

systemctl start kodi

Or for kodi-gbm:

systemctl start kodi-gbm

Dependency List

kodi (x11 or gbm)
polkit
xorg-server and xorg-xinit (for running x11)
libinput (for running gbm)

Acknowledgments

Much of the credit for this service goes to the Arch Linux maintainers of the official kodi package. Note that they removed it upon the 1.16-1 release of Xorg.

Tips and Tricks

Service not starting

Most users should not need /etc/X11/Xwrapper.config since the created X server becomes the controlling process of the VT to which it is bound. Most users does not mean all users. There have been reports of some AMD users still requiring this file. As well, users of Xorg's native modesetting driver may also require it.

The recommendation is to first try starting kodi.service without it, but if the service fails to start X, you may need to create /etc/X11/Xwrapper.config which should contain the following:

needs_root_rights = yes

Running Kodi web service on a privileged port

Users wishing to run the kodi web service on a privileged port (i.e. <1024) can simply use a systemd drop-in modification as follows:

[Service]
AmbientCapabilities=CAP_NET_BIND_SERVICE