Kodi-Headless Server als Docker-Container - NAS Hilfe und Support Forum

Inhaltsverzeichnis [Verbergen Anzeigen]

Kodi-Headless
Docker-Compose Schablone
Kodi Web-Interface Zugriff
NAT-Mode Hinweise
Advancedsettings.xml
Installation von Addons

Auf der Suche nach einer Möglichkeit, die Medienstruktur meiner Kodi-Mediathek auch über DLNA verfügbar zu machen, habe ich bisher nur zwei verlässliche Möglichkeiten gefunden. Einmal per Serviio (kann die Kodi NFO-Dateien verwenden und bereitet die Struktur entsprechend auf) und natürlich über den in Kodi integrierten DLNA-Server. Im Gegensatz zu Serviio unterstützt der Kodi-DLNA-Server allerdings keine Foto-Kategorie, sondern nur Musik und Videos.

Das Hauptproblem mit normalen Kodi war, dass es typischerweise nur dann läuft, wenn man es interaktiv verwendet und damit ist der DLNA-Server auch nur dann verfügbar.

1. Kodi-Headless

Kodi kann allerdings auch Headless betrieben werden (ohne UI), aber die Einrichtung ist nicht trivial. Glücklicherweise gibt es seit einiger Zeit einen Docker-Container dafür. Alle Infos darüber findet man hier:

GitHub: https://github.com/matthuisman/docker-kodi-headless
Docker-Hub: https://hub.docker.com/r/matthuisman/kodi-headless
Kodi-Forum: https://forum.kodi.tv/showthread.php?tid=370583

Das Ganze macht typischerweise nur Sinn, wenn man Kodi sowieso schon mit einer geteilten Datenbank verwendet (Einrichtung siehe auch Kodi für die Nutzung mit einer MySQL-Datenbank konfigurieren ). Die Fein-Konfiguration ist dann per Web-Interface möglich. Steuern kann man Kodi-Headless z.B. auch per YATSE, inklusive Casting auf andere Geräte.

Die Installation über die Container Station war zunächst recht einfach, allerdings war der DLNA-Server nicht im standardmäßigen NAT-Mode verwendbar (Web-Interface ging aber). Er wurde trotz aller erkennbar notwendigen manuellen Port-Mappings nicht von Clients erkannt. Deshalb habe ich den Container im Bridge-Mode konfiguriert und ihm eine eigene statische IP-Adresse aus meinem Heimnetzwerk gegeben. Damit funktioniert DLNA problemlos.

Wenn man die Konfiguration des Bridge-Mode aber nachträglich in der Container Station macht, geht diese Einstellung beim nächsten Container-Update (pull) verloren und muss erneut konfiguriert werden. Das ist natürlich nicht dauerhaft praktikabel, weshalb ich nach einer Möglichkeit per Docker-Compose Konfiguration gesucht habe und diese nun endlich auch gefunden habe. Leider konnte ich keine Dokumentation dazu finden und musste deshalb lange in den Tiefen des Internets suchen und bin schlussendlich auch in einer Diskussion im englischen QNAP-Forum fündig geworden.

2. Docker-Compose Schablone

Hier mal eine passende Schablone für Docker-Compose, die man direkt in der Container Station nutzen kann. Es müssen noch Benutzer (<user>), Passwort (<password>) und die IP (<ip-address1>) für die MySQL-DB eingetragen werden (ich nutze die auf dem NAS verfügbare MariaDB 10). Außerdem muss noch die IP-Adresse (<ip-address2>) für den DLNA-Server (Kodi) vergeben werden, die aus dem heimischen Netzwerk stammt, wo auch das NAS angemeldet ist. Achtung, diese muss außerhalb des DHCP-Bereichs liegen, der vom Router verwaltet wird!

Code: docker_compose.yml

version: '2.4'

services:
  kodi-headless:
    image: matthuisman/kodi-headless:Nexus
    container_name: kodi-headless
    environment:
      - PUID=<uid>
      - PGID=<gid>
      - MYSQL_HOST=<ip-address1>
      - MYSQL_USER=<user>
      - MYSQL_PASSWORD=<password>
      - TZ=Europe/Berlin
  volumes:
    - /share/<kodi_home_share>/:/config/.kodi
  network_mode: bridge
  networks:
    # see networks below
    qnet-static-eth0-12a456:
      ipv4_address: <ip-address2>
  ports:
    - 8080:8080 # web-ui server
    - 9090:9090 # web-socket server (json-rpc)
    - 9777:9777/udp # event server
  restart: unless-stopped

networks:
  # Note: Get qnet-static-eth0- from "docker network ls"
  qnet-static-eth0-12a456:
    external: true

Alles anzeigen

Die Container Station erzeugt einen virtuellen Adapter im QTS Virtual-Switch und gibt diesem einen zufälligen Namen. Dieser Name kann per ssh docker network ls abgefragt werden und muss dann unter "networks" eingetragen werden.

3. Kodi Web-Interface Zugriff

Das Kodi Web-Interface ist nach dem Start des Containers über http://<ip-address2>:8080 zu erreichen. Dort kann man z.B. die Sprache einstellen, nach der sich auch die Sprache der DLNA-Knoten richtet.

4. NAT-Mode Hinweise

Wenn man es doch per NAT-Modus versuchen möchte, muss gegenüber der Originalkonfigurationsempfehlung des Containers der Web-UI-Server Port angepasst werden, da 8080 schon für die QTS-Administrationsseite verwendet wird. Dann muss man diesen Port auch in der advancedsettings.xml einsprechend eintragen:

Code: advancedsettings.xml

<services>
  <webserverport>8080</webserverport>
</services>

Außerdem müssen in der docker_compose.yml alle für DLNA notwendigen Ports gemapped werden.

5. Advancedsettings.xml

Insgesamt sieht meine advancedsettings.xml so aus (es sind noch ein paar weitere Dinge hinsichtlich Netzwerk konfiguriert):

Code: advancedsettings.xml

<advancedsettings>
    <pathsubstitution>
      <!-- Siehe andere Anleitung zur Einrichtung einer zentralen Kodi-Datenbank -->
    </pathsubstitution>
    
    <videodatabase>
      <!-- Siehe andere Anleitung zur Einrichtung einer zentralen Kodi-Datenbank -->
    </videodatabase> 

    <musicdatabase>
      <!-- Siehe andere Anleitung zur Einrichtung einer zentralen Kodi-Datenbank -->
    </musicdatabase>
    
    <services>
        <devicename>Kodi (HEADLESS)</devicename>
        <esenabled>true</esenabled>
        <esallinterfaces>true</esallinterfaces>
        <escontinuousdelay>25</escontinuousdelay>
        <esinitialdelay>750</esinitialdelay>
        <esmaxclients>20</esmaxclients>
        <esport>9777</esport>
        <esportrange>10</esportrange>
        <upnpannounce>true</upnpannounce>
        <upnprenderer>false</upnprenderer>
        <upnpserver>true</upnpserver>
        <webserver>true</webserver>
        <!-- Optionale Anmeldung für Web-Interface
          <webserverusername>user</webserverusername>
          <webserverpassword>password</webserverpassword>
          <webserverauthentication>true</webserverauthentication>
        -->
        <webserverport>8080</webserverport>
        <zeroconf>true</zeroconf>
    </services>
    <jsonrpc>
        <tcpport>9090</tcpport>
    </jsonrpc>

    <!-- Optionale Anpassung der maximalen Größe der Cover
      <fanartres>500</fanartres>
      <imageres>500</imageres>
    -->

    <videolibrary>
        <importwatchedstate>true</importwatchedstate>
        <importresumepoint>true</importresumepoint>
        <exportautothumbs>false</exportautothumbs>
        <backgroundupdate>false</backgroundupdate>
    </videolibrary>
    <videoscanner>
        <ignoreerrors>true</ignoreerrors>
    </videoscanner>
    <musiclibrary>
        <backgroundupdate>false</backgroundupdate>
    </musiclibrary>

    <splash>false</splash>
    <lookandfeel>
        <enablerssfeeds>false</enablerssfeeds>
    </lookandfeel>
    <audiooutput>
        <guisoundmode>0</guisoundmode>
        <ac3passthrough>false</ac3passthrough>
        <dtspassthrough>false</dtspassthrough>
        <multichannellpcm>false</multichannellpcm>
        <truehdpassthrough>false</truehdpassthrough>
        <dtshdpassthrough>false</dtshdpassthrough>
        <mode>2</mode>
    </audiooutput>
    <nodvdrom>true</nodvdrom>
    <input>
        <enablemouse>false</enablemouse>
        <remoteaskeyboard>false</remoteaskeyboard>
    </input>
    <general>
        <addonnotifications>false</addonnotifications>
    </general>
    <skinsettings>
        <setting type="bool" name="skin.estuary.FirstTimeRun">false</setting>
        <setting type="bool" name="skin.confluence.FirstTimeRun">false</setting>
    </skinsettings>
    <loglevel>0</loglevel>
    
    <network>
        <disableipv6>true</disableipv6>
        <!-- <disablehttp2>true</disablehttp2> -->
        <curlretries>5</curlretries>
        <curlclienttimeout>30</curlclienttimeout>
        <curllowspeedtime>30</curllowspeedtime>
    </network>
    <cache>
        <buffermode>1</buffermode>
        <memorysize>139460608</memorysize>
        <readfactor>20</readfactor>
    </cache>
</advancedsettings>

Alles anzeigen

6. Installation von Addons

Die Installation von Addons ist auf der GitHub- und auch auf der Docker-Hub-Seite beschrieben (nur per Kommandozeile, braucht man aber normalerweise nicht).