Cache has no size cap and can fail to clear when disk is full

[milohansen]

What version of Music Assistant has the issue?

2.7.6

How is the MA server installed?

Home Assistant OS Addon

Mandatory: Carefully read the Troubleshooting FAQ and confirm that

• I have examined the logs and tried to resolve this issue
• I have fixed any errors in the logs that relate to tags
• I am not running MA across a VPN, VLAN, subnet, behind a firewall, or using local SSL or have any other complex network setup
• I am not using or have disabled tools such as AdGuard, Pi-hole or pfSense and retested
• I have checked my network setup to ensure mDNS/multicast is not being blocked
• I have reviewed the Open and Closed Issues and Discussions to resolve this yourself?
• I have reviewed the applicable player or music provider documentation
• I have reviewed the MA Status Page
• I have tried restarting MA and rebooting the host

As Applicable: Carefully read the Troubleshooting FAQ and confirm that

• If using HA, I have confirmed the internal URL is set correctly
• I have tried a wired connection for issues related to interrupted or poor playback quality
• If the problem relates to a device then I have checked the device settings
• If it is a frontend issue, I have tried a different widely used browser
• For voice problems, I have sought help elsewhere before returning here
• For playback problems, I have recycled power to the physical device

The problem

Music assistant has no cap on cache size and will allow the cache to fill the entire disk. See image:

Once the disk is full, the command to clear the cache fails because the disk is full:

Suggested fix:

Allow a user configurable max_cache_size to keep the cache in check.

How to reproduce

• Play music on a device for an extended period of time, allowing the cache to grow. (I was playing via Spotify).
• Attempt to clear the cache via Music Assistant -> Settings -> System

Music Providers

Spotify

Player Providers

The speaker that was playing is a Sonos

Full log output

music-assistant.log

Additional information

n/a

What version of Home Assistant Core (if used) are your running

2026.2.1

What type of installation are you running?

Home Assistant OS

On what type of hardware are you running?

Linux

Have you included ALL of the information specified in the Troubleshooting FAQ or explained why you cannot

• Yes

[marcelveldt]

Please update to the 2.7 version

[milohansen]

Whoops I mistyped the version, I'm on 2.7.6

[marcelveldt]

Ok that is strange then because we don't cache that much of data on disk. What size are we talking about?

[milohansen]

It was up to 12.9 Gigs. It might have been more if the storage disk wasn't completely full.