# Music Assistant

Music Assistant is a self-hosted, open-source music library manager for Home Assistant. It is open source and self-hosted, installable on ZimaOS, Kubernetes (Helm), Umbrel, Unraid and TrueNAS.

Canonical page: https://ourlocalhost.com/app/284/music-assistant

## Description

Music Assistant is a self-hosted, open-source music library manager for Home Assistant. It combines streaming services and local music files into one library and streams to supported speakers, smart displays, and audio players. It is for homelab users who want a unified music backend with multi-brand player support. Use it when you need local network discovery, flexible player pairing, and a single library for mixed music sources.

## Platform availability

Available on 6 of 10 platforms: Unraid, TrueNAS, Umbrel, ZimaOS, Helm, Any server.

## Health score

82/100 (Excellent), based on 4 of 4 factors.
- Maintained: 100 (last commit 17 days ago)
- Popular: 70 (3,279 GitHub stars)
- Easy to install: 85 (6 install platforms, install notes, Docker image)
- Light to run: 50 (2 GB minimum RAM)

## Links

- Documentation: https://music-assistant.io/documentation/
- ZimaOS: https://github.com/bigbeartechworld/big-bear-casaos/tree/master/Apps/music-assistant
- Kubernetes (Helm): https://artifacthub.io/packages/helm/bdclark-helm-charts/music-assistant
- Umbrel: https://apps.umbrel.com/app/music-assistant
- Unraid: https://ca.unraid.net/apps/music-assistant-0nqh84314a22lb?q=music-assistant
- TrueNAS: https://apps.truenas.com/catalog/music-assistant/
- Official website: https://music-assistant.io
- GitHub: https://github.com/music-assistant/server

## Common questions

### Where should I post bug reports and ask for support?

Check the troubleshooting page first, then create bug reports and discuss ideas in the project's separate support repository.

### Can I play local music to Alexa devices with Music Assistant?

Yes, a Reddit thread describes using the Music Assistant Home Assistant plugin to play local music to Alexa devices, including grouped speakers.

### Are non-standard setups supported?

Some core options help non-standard setups, but they are supplied on a non-support basis. Search Discord because users have often identified a fault in their own setup.

### Does each music service need its own account?

Yes, each service still needs its own account, even though Music Assistant combines sources into one library.

### Does Music Assistant collect or share playback data?

No, Music Assistant never collects or shares what you play, although online music services still handle their own streams.

## Alternatives

- Emby: Emby is a self-hosted media server that organizes personal video, music, photo, and live TV libraries and streams them to smart TVs, stream…
- Jellyfin: Jellyfin is a Free Software Media System that puts you in control of managing and streaming your media.
- Mediora: Transform your Apple TV into a powerful media hub with Mediora.
- Plex: Plex is a LinuxServer.io Docker container that runs Plex Media Server so home users can organize and stream personal video, music, and phot…

---
Source: Our Local Host (https://ourlocalhost.com/app/284/music-assistant), the self-hosted and open-source app directory.
