celedhrim/kodi-server repository overview

⁠docker-kodi-server

Run Kodi using docker as a server

This will allow you to

• serves files through the Kodi UPnP Library to your UPnP client/players (such as Kodi or Chromecast).
• Web access every time , or use with some tools like htpc-manager⁠
• Trigger library scan When you want using api or from sickbeard/sickrage/couchpotato/sonarr/radarr/...

⁠Preqrequisites:

• Docker (Follow the installation instructions⁠)
• A shared Library with mysql⁠ is higly recommended to shared library ( If you don't use UPnP)

⁠Quick start

1. Prepare a full kodi profile with the regular GUI version ( windows or linux )

If you require web access, make sure to enable this, and set the port to 8089. Because 8080 is default for http proxy , this docker image expose 8089

Advices for the profile:

• You don't need any display , personnaly I disable all menu and told kodi to start on settings
• As software fake display is use , every graphic change is cpu cost , disable library update progess ( Settings / Media / Library : Hide progress of library updates)
• Only configure scrapers , and set addons on auto update

1. Make a copy of the ~/.kodi directory ( destination doesn't matter , this is just an example)

    $ cp -r ~./kodi ~/kodi-server-profile
   

   Copy

2. Use prebuild docker image (see here⁠)

For the last stable version,

    $ docker pull celedhrim/kodi-server

For a specific version,

    $ docker pull celedhrim/kodi-server:branchname

1. Run the image ( change the /path/to/kodi-server-profile)

    $ docker run -d --restart="always" --net=host -v /path/to/kodi-server-profile:/usr/share/kodi/portable_data celedhrim/kodi-server
   

   Copy

   or if use specific branch

    $ docker run -d --restart="always" --net=host -v /path/to/kodi-server-profile:/usr/share/kodi/portable_data celedhrim/kodi-server:branchname
   

   Copy

⁠Build the container yourself

$ git clone https://github.com/Celedhrim/docker-kodi-server.git
$ cd docker-kodi-server
$ git checkout branchname
$ docker build --rm=true -t $(whoami)/kodi-server .

Then proceed with the Quick start section.