Self–hosting

Introduction

While it's very comfortable to use the user interface at https://heyarne.github.io/airsonic-ui, you may not want to rely on external services to access your beloved music collection. This guide covers the steps required to host this interface on your own server. It assumes you have a basic knowledge of working with the unix command line and is potentially sloppy. If you have any questions, feel free to open an issue!

Prerequisites

We assume you have already set up a proxy to access your airsonic instance. If you have not, please check out the documentation for that.

Setup

The following lines are meant to be run on your server in a bash shell; lines starting with # are comments, lines starting with $ are followed by the commands you should execute. Lines which start with neither a # nor a $ represent output of the previous command, even though some output might have been omitted.

# first, create a folder that the static files will get served from
$ mkdir /var/www/airsonic-ui && cd /var/www/airsonic-ui
# download the latest release and extract it
$ wget https://github.com/heyarne/airsonic-ui/archive/v0.2.tar.gz
$ tar xvf *.tar.gz --strip-components=1
$ ls
app/  fonts/  img/  index.html
$ rm v0.1.tar.gz
# Set up access rights
$ chown -R www-data:www-data .

Now that we have our files in place, configure your proxy (nginx in this case) to serve the directory /var/www/airsonic-ui. In your proxy config, you will have a location block like location /airsonic or something similar, depending on the exact location you serve airsonic from. You can configure the proxy to serve the new UI at /bling-bling by inserting this block before the other block:

location /bling-bling {
    alias /var/www/airsonic-ui;
}

Now test the config and reload nginx to use it:

$ nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
$ service nginx reload

Done! Have fun with your new user interface.