[Bug]: installation failed to register layer: Error processing tar file(exit status 1): archive/tar: invalid tar header

[stergios1]

Describe the bug

Upgrading from 5.19.2 and later returns with an error:
docker compose up -d
[+] up 13/15
⠋ Image brandawg93/peanut:5.20.0 [⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿] 62.06MB / 68.27MB Pulling 8.0s
failed to register layer: Error processing tar file(exit status 1): archive/tar: invalid tar header

Raspberry pi 5 with Bookworm
Linux 6.12.87+rpt-rpi-2712 #1 SMP PREEMPT Debian 1:6.12.87-1+rpt1~bookworm (2026-05-12) aarch64 GNU/Linux
docker --version
Docker version 20.10.24+dfsg1, build 297e128

Debug Output

installation fails

Steps to reproduce

1. compose.yaml file => image: brandawg93/peanut:5.20.0
2. docker compose up -d
   [+] up 13/15
   ⠋ Image brandawg93/peanut:5.20.0 [⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿] 62.06MB / 68.27MB Pulling 8.0s
   failed to register layer: Error processing tar file(exit status 1): archive/tar: invalid tar header

Device Type

raspberry pi 5

UPS Device

cyberpower

Last Working Version

5.19.2

[stergios1]

docker-compose --verbose pull
compose.config.config.find: Using configuration files: ./compose.yaml
compose.cli.docker_client.get_client: docker-compose version 1.29.2, build unknown
docker-py version: 5.0.3
CPython version: 3.11.2
OpenSSL version: OpenSSL 3.0.20 7 Apr 2026
compose.cli.docker_client.get_client: Docker base_url: http+docker://localhost
compose.cli.docker_client.get_client: Docker version: Platform={'Name': ''}, Components=[{'Name': 'Engine', 'Version': '20.10.24+dfsg1', 'Details': {'ApiVersion': '1.41', 'Arch': 'arm64', 'BuildTime': '2026-05-07T21:08:42.000000000+00:00', 'Experimental': 'false', 'GitCommit': '5d6db84', 'GoVersion': 'go1.19.8', 'KernelVersion': '6.12.87+rpt-rpi-2712', 'MinAPIVersion': '1.12', 'Os': 'linux'}}, {'Name': 'containerd', 'Version': '1.6.20ds1', 'Details': {'GitCommit': '1.6.20ds1-1+deb12u3'}}, {'Name': 'runc', 'Version': '1.1.5+ds1', 'Details': {'GitCommit': '1.1.5+ds1-1+deb12u1'}}, {'Name': 'docker-init', 'Version': '0.19.0', 'Details': {'GitCommit': ''}}], Version=20.10.24+dfsg1, ApiVersion=1.41, MinAPIVersion=1.12, GitCommit=5d6db84, GoVersion=go1.19.8, Os=linux, Arch=arm64, KernelVersion=6.12.87+rpt-rpi-2712, BuildTime=2026-05-07T21:08:42.000000000+00:00
compose.cli.verbose_proxy.proxy_callable: docker inspect_network <- ('peanut_default')
compose.cli.verbose_proxy.proxy_callable: docker inspect_network -> {'Attachable': False,
'ConfigFrom': {'Network': ''},
'ConfigOnly': False,
'Containers': {'5a1600b2bed8e81be6990817d2abc2e181b635569a863dded736ae23405fd26d': {'EndpointID': '2cf660c84f2676015cc90835813e3a9cceecc0dc563bb473805d0626d16b48db',
'IPv4Address': '172.25.0.2/16',
'IPv6Address': '',
'MacAddress': '02:42:ac:19:00:02',
'Name': 'PeaNUT'}},
'Created': '2026-05-21T16:46:58.272563836+03:00',
'Driver': 'bridge',
...
Pulling peanut ...
compose.parallel.feed_queue: Pending: {<Service: peanut>}
compose.parallel.feed_queue: Starting producer thread for <Service: peanut>
compose.cli.verbose_proxy.proxy_callable: docker pull <- ('brandawg93/peanut', tag='5.20.0', stream=True, platform=None)
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... pulling from brandawg93/peanut
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... waiting
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... extracting (18.1%)
Pulling peanut ... downloading (14.8%)
Pulling peanut ... downloading (51.8%)
Pulling peanut ... download complete
Pulling peanut ... downloading (12.4%)
Pulling peanut ... downloading (16.5%)
Pulling peanut ... download complete
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... downloading (21.6%)
Pulling peanut ... downloading (26.8%)
Pulling peanut ... downloading (31.0%)
Pulling peanut ... downloading (34.1%)
Pulling peanut ... downloading (38.2%)
Pulling peanut ... downloading (43.4%)
Pulling peanut ... downloading (48.5%)
Pulling peanut ... download complete
Pulling peanut ... downloading (56.8%)
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... downloading (63.0%)
Pulling peanut ... downloading (68.1%)
Pulling peanut ... downloading (73.3%)
Pulling peanut ... download complete
Pulling peanut ... downloading (1.0%)
Pulling peanut ... downloading (86.8%)
Pulling peanut ... downloading (91.9%)
Pulling peanut ... downloading (98.1%)
Pulling peanut ... downloading (39.0%)
Pulling peanut ... downloading (52.4%)
Pulling peanut ... downloading (73.9%)
Pulling peanut ... downloading (83.2%)
Pulling peanut ... download complete
Pulling peanut ... download complete
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... download complete
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... download complete
compose.parallel.parallel_execute_iter: Failed: <Service: peanut>
compose.parallel.feed_queue: Pending: set()

ERROR: for peanut failed to register layer: Error processing tar file(exit status 1): archive/tar: invalid tar header
ERROR: compose.cli.main.exit_with_metrics: failed to register layer: Error processing tar file(exit status 1): archive/tar: invalid tar header

[stergios1]

docker-compose --verbose --log-level=debug pull
compose.config.config.find: Using configuration files: ./compose.yaml
compose.cli.docker_client.get_client: docker-compose version 1.29.2, build unknown
docker-py version: 5.0.3
CPython version: 3.11.2
OpenSSL version: OpenSSL 3.0.20 7 Apr 2026
compose.cli.docker_client.get_client: Docker base_url: http+docker://localhost
compose.cli.docker_client.get_client: Docker version: Platform={'Name': ''}, Components=[{'Name': 'Engine', 'Version': '20.10.24+dfsg1', 'Details': {'ApiVersion': '1.41', 'Arch': 'arm64', 'BuildTime': '2026-05-07T21:08:42.000000000+00:00', 'Experimental': 'false', 'GitCommit': '5d6db84', 'GoVersion': 'go1.19.8', 'KernelVersion': '6.12.87+rpt-rpi-2712', 'MinAPIVersion': '1.12', 'Os': 'linux'}}, {'Name': 'containerd', 'Version': '1.6.20ds1', 'Details': {'GitCommit': '1.6.20ds1-1+deb12u3'}}, {'Name': 'runc', 'Version': '1.1.5+ds1', 'Details': {'GitCommit': '1.1.5+ds1-1+deb12u1'}}, {'Name': 'docker-init', 'Version': '0.19.0', 'Details': {'GitCommit': ''}}], Version=20.10.24+dfsg1, ApiVersion=1.41, MinAPIVersion=1.12, GitCommit=5d6db84, GoVersion=go1.19.8, Os=linux, Arch=arm64, KernelVersion=6.12.87+rpt-rpi-2712, BuildTime=2026-05-07T21:08:42.000000000+00:00
compose.cli.verbose_proxy.proxy_callable: docker inspect_network <- ('peanut_default')
compose.cli.verbose_proxy.proxy_callable: docker inspect_network -> {'Attachable': False,
'ConfigFrom': {'Network': ''},
'ConfigOnly': False,
'Containers': {'5a1600b2bed8e81be6990817d2abc2e181b635569a863dded736ae23405fd26d': {'EndpointID': '2cf660c84f2676015cc90835813e3a9cceecc0dc563bb473805d0626d16b48db',
'IPv4Address': '172.25.0.2/16',
'IPv6Address': '',
'MacAddress': '02:42:ac:19:00:02',
'Name': 'PeaNUT'}},
'Created': '2026-05-21T16:46:58.272563836+03:00',
'Driver': 'bridge',
...
Pulling peanut ...
compose.parallel.feed_queue: Pending: {<Service: peanut>}
compose.parallel.feed_queue: Starting producer thread for <Service: peanut>
compose.cli.verbose_proxy.proxy_callable: docker pull <- ('brandawg93/peanut', tag='5.20.0', stream=True, platform=None)
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... pulling from brandawg93/peanut
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... waiting
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... downloading (1.0%)
Pulling peanut ... downloading (16.7%)
Pulling peanut ... downloading (4.1%)
Pulling peanut ... downloading (79.6%)
Pulling peanut ... download complete
Pulling peanut ... downloading (13.3%)
Pulling peanut ... downloading (16.4%)
Pulling peanut ... downloading (20.5%)
Pulling peanut ... downloading (25.7%)
Pulling peanut ... downloading (30.9%)
Pulling peanut ... downloading (36.0%)
Pulling peanut ... downloading (41.2%)
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... download complete
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... downloading (50.5%)
Pulling peanut ... download complete
Pulling peanut ... downloading (58.7%)
Pulling peanut ... downloading (61.8%)
Pulling peanut ... downloading (66.0%)
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... download complete
Pulling peanut ... downloading (74.2%)
Pulling peanut ... downloading (80.4%)
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... downloading (1.0%)
Pulling peanut ... downloading (2.0%)
Pulling peanut ... downloading (3.1%)
Pulling peanut ... downloading (99.0%)
Pulling peanut ... downloading (4.1%)
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... downloading (6.1%)
Pulling peanut ... downloading (8.2%)
Pulling peanut ... downloading (16.0%)
Pulling peanut ... downloading (53.1%)
Pulling peanut ... downloading (11.3%)
Pulling peanut ... download complete
Pulling peanut ... downloading (13.3%)
Pulling peanut ... downloading (15.4%)
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... downloading (17.5%)
Pulling peanut ... download complete
Pulling peanut ... downloading (19.5%)
Pulling peanut ... downloading (21.6%)
Pulling peanut ... download complete
Pulling peanut ... downloading (26.7%)
Pulling peanut ... downloading (28.8%)
Pulling peanut ... downloading (31.9%)
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... downloading (35.0%)
Pulling peanut ... downloading (37.0%)
Pulling peanut ... downloading (39.1%)
Pulling peanut ... downloading (42.2%)
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... downloading (46.3%)
Pulling peanut ... downloading (50.4%)
Pulling peanut ... downloading (54.5%)
Pulling peanut ... downloading (59.6%)
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... downloading (64.8%)
Pulling peanut ... downloading (67.9%)
Pulling peanut ... downloading (70.9%)
Pulling peanut ... downloading (77.1%)
Pulling peanut ... downloading (82.2%)
Pulling peanut ... downloading (85.3%)
Pulling peanut ... downloading (89.5%)
compose.parallel.feed_queue: Pending: set()
Pulling peanut ... downloading (95.7%)
Pulling peanut ... download complete
compose.parallel.parallel_execute_iter: Failed: <Service: peanut>
compose.parallel.feed_queue: Pending: set()

ERROR: for peanut failed to register layer: Error processing tar file(exit status 1): archive/tar: invalid tar header
ERROR: compose.cli.main.exit_with_metrics: failed to register layer: Error processing tar file(exit status 1): archive/tar: invalid tar header