{"id":13816039,"url":"https://github.com/linuxserver-archive/docker-kodi-headless","last_synced_at":"2025-05-15T12:31:12.730Z","repository":{"id":36608590,"uuid":"40914763","full_name":"linuxserver-archive/docker-kodi-headless","owner":"linuxserver-archive","description":null,"archived":true,"fork":false,"pushed_at":"2022-02-23T22:48:01.000Z","size":178,"stargazers_count":125,"open_issues_count":0,"forks_count":43,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-05-06T14:23:21.751Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/linuxserver-archive.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-08-17T17:34:18.000Z","updated_at":"2025-04-05T19:31:40.000Z","dependencies_parsed_at":"2022-08-28T11:31:07.499Z","dependency_job_id":null,"html_url":"https://github.com/linuxserver-archive/docker-kodi-headless","commit_stats":null,"previous_names":["linuxserver-archive/docker-kodi-headless"],"tags_count":174,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linuxserver-archive%2Fdocker-kodi-headless","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linuxserver-archive%2Fdocker-kodi-headless/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linuxserver-archive%2Fdocker-kodi-headless/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/linuxserver-archive%2Fdocker-kodi-headless/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/linuxserver-archive","download_url":"https://codeload.github.com/linuxserver-archive/docker-kodi-headless/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254314200,"owners_count":22050188,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-04T05:00:31.581Z","updated_at":"2025-05-15T12:31:12.707Z","avatar_url":"https://github.com/linuxserver-archive.png","language":"Dockerfile","funding_links":[],"categories":["Dockerfile"],"sub_categories":[],"readme":"# DEPRECATION NOTICE\n\nThis image is deprecated. We will not offer support for this image and it will not be updated.\nThis project is no longer maintained.\n\n[linuxserverurl]: https://linuxserver.io\n[forumurl]: https://forum.linuxserver.io\n[ircurl]: https://www.linuxserver.io/index.php/irc/\n[podcasturl]: https://www.linuxserver.io/index.php/category/podcast/\n[appurl]: https://kodi.tv/\n[hub]: https://hub.docker.com/r/linuxserver/kodi-headless/\n\n[![linuxserver.io](https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/linuxserver_medium.png)][linuxserverurl]\n\nThe [LinuxServer.io][linuxserverurl] team brings you another container release featuring easy user mapping and community support. Find us for support at:\n* [forum.linuxserver.io][forumurl]\n* [IRC][ircurl] on freenode at `#linuxserver.io`\n* [Podcast][podcasturl] covers everything to do with getting the most from your Linux Server plus a focus on all things Docker and containerisation!\n\n# linuxserver/kodi-headless\n[![](https://images.microbadger.com/badges/version/linuxserver/kodi-headless.svg)](https://microbadger.com/images/linuxserver/kodi-headless \"Get your own version badge on microbadger.com\")[![](https://images.microbadger.com/badges/image/linuxserver/kodi-headless.svg)](https://microbadger.com/images/linuxserver/kodi-headless \"Get your own image badge on microbadger.com\")[![Docker Pulls](https://img.shields.io/docker/pulls/linuxserver/kodi-headless.svg)][hub][![Docker Stars](https://img.shields.io/docker/stars/linuxserver/kodi-headless.svg)][hub][![Build Status](https://ci.linuxserver.io/buildStatus/icon?job=Docker-Builders/x86-64/x86-64-kodi-headless)](https://ci.linuxserver.io/job/Docker-Builders/job/x86-64/job/x86-64-kodi-headless/)\n\nA headless install of kodi in a docker container, most useful for a mysql setup of kodi to allow library updates to be sent without the need for a player system to be permanently on.\n\n[![kodi](https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/kodi-banner.png)][appurl]\n\n## Usage\n\n```\ndocker create --name=kodi-headless \\\n-v \u003cpath to data\u003e:/config/.kodi \\\n-e PGID=\u003cgid\u003e -e PUID=\u003cuid\u003e \\\n-e TZ=\u003ctimezone\u003e \\\n-p 8080:8080 \\\n-p 9090:9090 \\\n-p 9777:9777/udp \\\nlinuxserver/kodi-headless\n```\n\nYou can choose between ,using tags, various main versions of kodi.\n\nAdd one of the tags,  if required,  to the linuxserver/kodi-headless line of the run/create command in the following format, linuxserver/kodi-headless:Krypton\n\n#### Tags\n+ **Helix**\n+ **Isengard**\n+ **Jarvis**\n+ **Krypton**\n+ **Leia** : current default branch.\n\n\n**Parameters**\n\n* `-p 8080` - webui port\n* `-p 9090` - websockets port\n* `-p 9777/udp` - esall interface port\n* `-v /config/.kodi` - path for kodi configuration files\n* `-e PGID` for GroupID - see below for explanation\n* `-e PUID` for UserID - see below for explanation\n* `-e TZ` - for timezone information *eg Europe/London, etc*\n\nIt is based on ubuntu bionic with s6 overlay, for shell access whilst the container is running do `docker exec -it kodi-headless /bin/bash`.\n\n### User / Group Identifiers\n\nSometimes when using data volumes (`-v` flags) permissions issues can arise between the host OS and the container. We avoid this issue by allowing you to specify the user `PUID` and group `PGID`. Ensure the data volume directory on the host is owned by the same user you specify and it will \"just work\" ™.\n\nIn this instance `PUID=1001` and `PGID=1001`. To find yours use `id user` as below:\n\n```\n  $ id \u003cdockeruser\u003e\n    uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)\n```\n\n## Setting up the application\n\nMysql/mariadb settings are entered by editing the file advancedsettings.xml which is found in the userdata folder of your /config/.kodi mapping. Many other settings are within this file also.\n\nThe default user/password for the web interface and for apps like couchpotato etc to send updates is kodi/kodi.\n\nIf you intend to use this kodi instance to perform library tasks other than merely updating, eg. library cleaning etc, it is important to copy over the sources.xml from the host machine that you performed the initial library scan on to the userdata folder of this instance, otherwise database loss can and most likely will occur.\n\nRar integration with the Leia branch is now handled by an addon,\nit is compiled with this build, but you will need to enable it, if required, in the settings section of the webui.\n\n## Info\n\n* Shell access whilst the container is running: `docker exec -it kodi-headless /bin/bash`\n* To monitor the logs of the container in realtime: `docker logs -f kodi-headless`\n\n## Credits\nFor inspiration, and most importantly, the headless patches without which none of this would have been possible. \n\n+ [Celedhrim](https://github.com/Celedhrim)\n+ [sinopsysHK](https://github.com/sinopsysHK)\n+ [wernerb](https://github.com/wernerb)\n\nVarious other members of the xbmc/kodi community for advice.\n\n## Versions\n\n+ **07.01.20:** Bump Leia to 18.5.\n+ **23.06.19:** Bump Leia to 18.4.\n+ **23.04.19:** Bump Leia to 18.2.\n+ **09.03.19:** Build vfs.libarchive and vfs.rar addons.\n+ **08.03.19:** Make Leia default branch, using patched \"headless\" build.\n+ **30.01.19:** Bump Leia branch to release ppa.\n+ **03.09.18:** Add back libnfs dependency.\n+ **31.08.18:** Rebase to ubuntu bionic, use buildstage and add info about websockets port.\n+ **04.01.18:** Deprecate cpu_core routine lack of scaling.\n+ **14.12.17:** Fix continuation lines.\n+ **17.11.17:** Bump Krypton to 17.6.\n+ **24.10.17:** Bump Krypton to 17.5.\n+ **22.08.17:** Bump Krypton to 17.4.\n+ **25.05.17:** Bump Krypton to 17.3.\n+ **23.05.17:** Bump Krypton to 17.2.\n+ **23.04.17:** Refine cmake, use cmake ppa and take out uneeded bootstrap line.\n+ **22.02.17:** Switch to using cmake build system.\n+ **22.02.17:** Bump Krypton to 17.1.\n+ **22.02.17:** Change default webui user/pw to kodi/kodi.\n+ **05.02.17:** Move Krypton to default branch.\n+ **20.09.16:** Add kodi-send and fix var cache samba permissions.\n+ **10.09.16:** Add layer badge to README..\n+ **02.09.16:** Rebase to alpine linux.\n+ **13.03.16:** Make kodi 16 (jarvis) default installed version.\n+ **21.08.15:** Initial Release.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinuxserver-archive%2Fdocker-kodi-headless","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flinuxserver-archive%2Fdocker-kodi-headless","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flinuxserver-archive%2Fdocker-kodi-headless/lists"}