From ArchWiki

Groovebasin is a music player server with a web-based user interface.

Run it on a server connected to some speakers in your home or office. Guests can control the music player by connecting with a laptop, tablet, or smart phone. Further, you can stream your music library remotely.

Groove Basin works with your personal music library; not an external music service. Groove Basin will never support DRM content.


Install the nodejs-groovebasinAUR package from the Arch User Repository.


A configuration file is located in /etc/groovebasin.json you need to provide groovebasin with a configuration file or it will create a new one in the current directory named config.json.

Start the Server

To start groovebasin as a regular user run

$ groovebasin --start

A unit file is also available to start groovebasin.service.

Web Interface

Open on your browser https://localhost:16242/.


NGINX can be used to redirect traffic from port 16242 to 80 with the following configuration.

location /groove/ {
        proxy_set_header    X-Real-IP  $remote_addr;
        proxy_set_header    X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header    Host $http_host;
        proxy_redirect      off;
        proxy_http_version  1.1;
        proxy_set_header    Upgrade $http_upgrade;
        proxy_set_header    Connection "upgrade";