Remote Access Settings

Remote Access allows you to securely connect to your Music Assistant server from anywhere in the world. It is also what lets the built-in web player reach your server from outside your own network.

Configuration

• Toggle the Remote Access Status to on. Setup is automatic and further instructions are shown in the MA UI
• If you have a Nabu Casa (Home Assistant Cloud) subscription, ensure the option WebRTC Connections (in the Home Assistant Cloud settings) is ON

To connect from elsewhere, go to app.music-assistant.io and enter Your Remote Access ID shown on this page, or scan the QR code shown below it.

For most users this is all that is needed.

Links shared with guests

Links that Music Assistant hands out to guests, such as the QR codes in party and quiz invitations, need an address that works from outside your home. The Music Assistant URL card at the top of Settings → System → Webserver decides which one is used.

• Internet. With remote access on, administrators see a Use remote access switch. When it is on, guests’ links open through remote access, and the card shows the link with a button to copy it. Switch it off to enter an External URL instead, for example the address of your own reverse proxy. A set external URL always takes priority over remote access. When remote access is off, the card offers Set up remote access, which opens this page
• Local network. Automatic is on by default and shows the address Music Assistant detected for devices in your home, with a button to copy it. Switch it off to enter an Internal URL yourself. See Webserver for when that is needed

Technical Details

Remote access usually works without a Nabu Casa subscription. The exception is complex network environments, for example double NAT, mobile carriers, or corporate networks blocking standard STUN servers. This is where TURN servers (which Nabu Casa provides) are useful as they relay the traffic.

Further information is shown in the MA UI. For the network terms used elsewhere in this documentation, see Networking Basics.