[BUG] Docker-TVHeadend hangs up on Debian Trixie

[Starfoxfs]

Is there an existing issue for this?

• I have searched the existing issues

Current Behavior

Newest Docker-TVHeadend and also older Versions hanging up on a Debian Trixie based Raspberry Pi 4B Docker Container.

After starting TVHeadend Docker the CPU goes to 100% with a Process named /usr/bin/tvheadend -c -C /config

I have posted Details also here:
https://github.com/orgs/linuxserver/discussions/42

The TVHeadend Admin Interface isnt reachable, only the CPU hangs on 100% see above

Expected Behavior

Run Docker TvHeadend and TVHeadend starts up

Steps To Reproduce

1. Use a Debian Trixie based System arm64v8
2. Install Docker
3. Run Docker TVheadend

Environment

- OS:Debian 1:6.12.47-1+rpt1 (2025-09-16) aarch64 GNU/Linux
- How docker service was installed: Description from this Site: https://docs.docker.com/engine/install/debian/

CPU architecture

arm64

Docker creation

services:
  tvheadend:
    image: lscr.io/linuxserver/tvheadend:latest
    container_name: tvheadend
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Berlin      
    volumes:
      - /home/docker/tvheadend/:/config
      - /home/docker/tvheadend/recordings:/recordings
    ports:
      - 9981:9981
      - 9982:9982
    restart: unless-stopped

Container logs

[migrations] started
[migrations] no migrations found
───────────────────────────────────────

  ██╗     ███████╗██╗ ██████╗
  ██║     ██╔════╝██║██╔═══██╗
  ██║     ███████╗██║██║   ██║
  ██║     ╚════██║██║██║   ██║
  ███████╗███████║██║╚██████╔╝
  ╚══════╝╚══════╝╚═╝ ╚═════╝

Brought to you by linuxserver.io
───────────────────────────────────────

To support LSIO projects visit:
https://www.linuxserver.io/donate/

───────────────────────────────────────
GID/UID
───────────────────────────────────────

User UID: 1000
User GID: 1000
───────────────────────────────────────
Linuxserver.io version: d4dff154-ls263
Build-date: 2025-10-11T15:40:48+00:00
───────────────────────────────────────

Setting permissions
[custom-init] No custom files found, skipping...
2025-10-14 11:17:04.783 [ INFO] main: Log started
2025-10-14 11:17:04.783 [ INFO] config: Using configuration from '/config'
2025-10-14 11:17:04.784 [ INFO] http: Starting HTTP server 0.0.0.0:9981
2025-10-14 11:17:04.784 [ INFO] htsp: Starting HTSP server 0.0.0.0:9982
2025-10-14 11:17:04.789 [ INFO] config: backup: migrating config from unknown (running 4.3-2477~gd4dff154a)
2025-10-14 11:17:04.789 [ INFO] config: backup: running, output file /config/backup/unknown.tar.bz2
2025-10-14 11:17:04.791 [ INFO] spawn: Executing "/bin/tar"
Connection to localhost (127.0.0.1) 9981 port [tcp/*] succeeded!
[ls.io-init] done.

[github-actions]

Thanks for opening your first issue here! Be sure to follow the relevant issue templates, or risk having this issue marked as invalid.

[j0nnymoe]

Oh from that log, you can see it spawning tar which means it's doing a backup of your /config mount. How long did you leave it til run?

[Starfoxfs]

Very long last time i stopped the Container after 20 Minutes because my Raspberry Pi Fan spins on and on.

The Raspi heats up because one CPU Core is at 100%

[j0nnymoe]

One last thing, I'm assuming you're doing this with existing /config data. Could you try with a blank/empty folder?

[Starfoxfs]

I have tried it already with a complete fresh install (empty Folder) and with an existing Folder its the same Problem.

[Starfoxfs]

I have searched a bit.

TVHeadend is running inside the Container but stays also at 100% CPU (hangs)

Thats a screen of Bash inside the Docker TVheadend Container and use "Top" for running processes:

I have inspected the running Container with Docker inspect tvheadend

Thats the Log:

inspect.log

I hope this helps to find the Bug

[hessijames79]

Got the exact same problem. When looking inside the container, tar is not even running. linuxserver/tvheadend:version-b3974f7d runs perfectly.

[Starfoxfs]

:Edit: Yes, Its not completly extracted

:Edit2: I have found the issue, the Docker Container downloads or have a compressed File unknown.tar.bz2 this File is corrupt, in my Bookworm installs before the tar.bz2 was named 4.3-2426~gd1fb6da0a.tar.bz2 and so on and have a much bigger size. The unknown.tar.bz2 is very small 3,4 kb the other 6,5mb

Now Developers can fix it

[j0nnymoe]

We are looking at rebasing this container here: #270 to fix this issue + give the container some TLC.
No ETA on when this will be completed.

[mwawra]

Hello, this might be a problem with the arm-container. I'm running TVHeadend on Trixie with Podman on x86 without this problem. Also the GUI is working fine.

[Starfoxfs]

Some News here ? i have tried latest Version and it didnt run same Problem unknown.tar.bz2 in Logs

[jansohn]

You should try not placing your recordings volume mount in the same directory as the config directory. Move the config files to a sub-directory like /home/docker/tvheadend/config. Also check the backup directory and clean/move the files elsewhere...
If your config directory only contains Tvheadend config files then the tar process will finish fast during boot up.

[Starfoxfs]

This changes nothing if i add it to another Directory. The Problem is the unkown.tar.bz2 the Script is broken somewhere for Debian Trixie especially arm64 build.