Get started · about 10 minutes

Install Music Assistant

Music Assistant runs on a device in your home that stays on. Pick where it runs and follow a few steps.

Recommended

Home Assistant app

If you run Home Assistant OS

Installs next to Home Assistant, updates with a click and connects to voice and automations.

Open the App store

In Home Assistant, go to Settings → Apps → App store.
Install Music Assistant

Search for Music Assistant, open it and choose Install.
Start it

When it’s installed, choose Start, then Open Web UI.

Open in Home Assistant Add the integration

Docker Compose

On your own Linux server

Host networking is required so it can find and stream to your speakers.

Create a Compose file

Save this as compose.yaml. Uncomment the music line to include local files.

compose.yaml

services:
  music-assistant-server:
    image: ghcr.io/music-assistant/server:latest
    container_name: music-assistant-server
    restart: unless-stopped
    network_mode: host
    volumes:
      - ${USERDIR:-$HOME}/docker/music-assistant-server/data:/data/
      # - /path/to/your/music:/media:ro
    environment:
      - LOG_LEVEL=info

Start it

Run this from the folder with your Compose file.
Terminal
```
docker compose up -d
```
Open Music Assistant

Go to http://YOUR_SERVER_IP:8095 in your browser.

Full Docker guide

Not sure? If you already use Home Assistant, choose the app. Speakers not showing up later? Check that they are on the same network as Music Assistant, with no VLANs in between.

Then, three things

01 · Sources
Add your music

Connect a streaming service, local files, radio or another source from Settings.
02 · Speakers
Check your speakers

Supported AirPlay, Google Cast, DLNA, Sendspin and Sonos players are discovered automatically.
03 · Play
Press play

Choose a speaker and press play. Your library may take a few minutes to appear.

Stuck? Read the installation guide or ask on Discord.

Home Assistant app

Open the App store