Skip to content

Installation

Note

Ensure the MA server is up and running properly with music and player providers added before trying to link it to HA via the integration

Installation of the HA Integration

The Integration to connect Music Assistant to Home Assistant is available as an official component in HA core.

  • The MA server will normally be discovered automatically by HA and is installed by clicking on CONFIGURE.
  • If for some reason you need to add the integration manually then go to HA SETTINGS >> DEVICES & SERVICES >> INTEGRATIONS and click the big + ADD INTEGRATION button. Search for Music Assistant and click to add it. You will need to add the server IP and port (usually 8095). Search for the relevant line in the server logs. For example, Starting server on 172.30.32.1:8095.
  • Click SUBMIT and the Music Assistant integration is ready for use.

Note

The HA integration will create new media_player entities for those player types which are supported natively by MA. To see the names of those players go to HA SETTINGS >> DEVICES & SERVICES >> INTEGRATIONS >> MUSIC ASSISTANT and view the entities. It is these players that need to be targeted in automations and scripts

Actions

Music Assistant provides (next to the standard media player actions), several custom actions to allow control over the players and media. See the Home Assistant documentation for information.

FAQ / Extra Info