FAQ & Troubleshooting
General questions
Is Mobile MA the official Music Assistant app?
No. Mobile MA is an independent project by Sven Hanold and is not affiliated with, developed, endorsed or reviewed by the Music Assistant project or the Open Home Foundation. The app uses the open API of your own Music Assistant server. You will find the official app and everything about the project at music-assistant.io.
What do I need to use Mobile MA?
A self-hosted Music Assistant server (version 2.9 or later) your iPhone can reach. Mobile MA is an independent client — the server runs on your side, e.g. as a Home Assistant add-on or Docker container.
Why Mobile MA when there is an official app?
The official Music Assistant app is open source, free and built for Android and iOS. Mobile MA is an independent, unofficial client for Apple devices only, available on the App Store. The difference: Apple Watch, Apple TV, Mac, Home Screen widgets and Siri Shortcuts with a target room, which the official app does not currently include; CarPlay for every player in the house including the queue, and saved multi-room scenes – two areas the project explicitly does not pursue for its app. Plus connection profiles, guided setup with server discovery and an app in ten languages. Core functions are free; the rest is a one-time purchase, no subscription. Both apps use the same server and run side by side. (As of 30 October 2026)
What is Mobile MA Unlimited?
A one-time purchase (no subscription) that unlocks every premium feature — including CarPlay, Smart Playlists and queue transfer. On your first tap on a premium feature you can start a free 7-day trial – no payment, no automatic renewal; afterwards you decide about the one-time purchase.
Does Mobile MA work with CarPlay?
Yes — with Mobile MA Unlimited your complete library is available in the car: albums, playlists, podcasts, radio and favourites, artwork included.
Is there a Mac version of Mobile MA?
Yes — since version 3.9 as a dedicated app on the Mac App Store, with a sidebar, keyboard shortcuts, widgets and a player in the menu bar. It requires macOS 26 or later. Your Unlimited purchase also applies on the Mac; without Unlimited you control one player there.
Is any data sent to the developer?
Your music, your server and your credentials: no — the app only talks to your own server. The single exception is anonymous usage statistics (events about setup, connection, trial, purchase and hints shown, no IP address or device ID – the full list is in the privacy policy) that you can switch off at any time in Settings under “Privacy”. Details are in the privacy policy.
Troubleshooting
Music stutters or drops out
Increase the playback buffer in Settings — it smooths over dead zones and flaky Wi-Fi. A larger buffer is especially worthwhile when streaming over cellular.
I want to access my server away from home
Set up Remote Access via WebRTC in Settings — it lets you reach your Music Assistant outside your home network without port forwarding or a VPN. On cellular there is one limitation, see the next entry.
Remote access works on Wi-Fi but not on cellular
Mobile carriers usually block direct WebRTC connections. To connect anyway, your Music Assistant server needs a TURN relay — and Music Assistant only provides one with a Home Assistant Cloud (Nabu Casa) subscription, because that is where the cost of the relayed traffic is covered. Without that subscription, remote access only works on your own network, via VPN, or through a server that is reachable from the outside. This is a property of the server, not of the app — see the reply from the Music Assistant team.
A player is missing from the list
First check that the player is active and available in the Music Assistant server itself. In the app, pull to refresh; after network changes Mobile MA reconnects automatically.
Local playback stops when switching between Wi-Fi and cellular
Fixed since version 2.0 — please update the app to the latest version.
The widget doesn't refresh
Make sure the latest app version is installed (much more reliable since 2.3) and that Background App Refresh is allowed for Mobile MA in iOS Settings.