Setting up a Node Sonos API using

I wanted to build some home automation on my Sonos speakers. After some research, I decided that the most straightforward way to do this would be to fork a project I’d found on GitHub into this one, change some of the default settings, and add a Dockerfile so it could be deployed to a Raspberry Pi via

The other advantage of using Resin is that it provides the ability to forward a public URL to your Pi without having to deal with NAT traversal.

So, let’s get started.

1. Set up your Resin project and install ResinOS

Instructions for this can be found here.

2. Push to Resin remote

Clone my repo, add your Resin remote, then push to there (instructions).


It’ll take a few minutes to build and deploy to your device. Grab yourself a coffee (or a beer).

3. Set environment variables

In the Resin dashboard, set the following environment variables:

  • AUTH enables HTTP basic auth. This is essential if you’re forwarding a public URL to your device.
  • AUTH_USERNAME Pick a random username for this one.
  • AUTH_PASSWORD Pick a random password for this one.

Optionally, set the PRESET_DIR directory to “/data/presets” if you’d like to have Sonos presets persist through app updates. (The /data directory on Resin is persistent).


4. Enable public URL

Enable a public URL to your device by visiting Actions -> Public URL.


5. Enjoy!

And you’re done! Visit the public URL to see your Sonos API server. The main page should render, but you’ll need to authenticate with the credentials you’d set in the environment variables to hit any other endpoints.


Written on May 16, 2017