Skip to main content


Airsonic is a web-based audio player.

It is a maintained forked of Subsonic, with the paid components modified to be free.

Adding more users' media to Airsonic

Airsonic runs as the user airsonic. This means, that this user needs to be able to read (and execute directories leading all the way up to) whatever you would like airsonic to play.

During the installation, only the master user is present in this group.

In order to access non-master-user files cleanly, please add the airsonic user to the group of users who can access the desired user's files, and ensure that this group has access to the media you would like to access.

usermod -a -G <aUser> airsonic
chmod g+rx -R /home/<aUser>

Migrating from Subsonic

The below command set are the adjusted instructions for the swizzin environment, originally adapted from here. They have not been thoroughly tested, please report in the Discord if you've had any issues.

sudo cp -a /srv/subsonic /var/airsonic
sudo mv /var/airsonic/subsonic_sh.log /var/airsonic/airsonic_sh.log
sudo mv /var/airsonic/subsonic.log /var/airsonic/airsonic.log
sudo mv /var/airsonic/ /var/airsonic/
sudo mv /var/airsonic/db/subsonic.backup /var/airsonic/db/airsonic.backup
sudo mv /var/airsonic/db/ /var/airsonic/db/
sudo mv /var/airsonic/db/subsonic.lck /var/airsonic/db/airsonic.lck
sudo mv /var/airsonic/db/subsonic.log /var/airsonic/db/airsonic.log
sudo mv /var/airsonic/db/ /var/airsonic/db/
sudo mv /var/airsonic/db/subsonic.script /var/airsonic/db/airsonic.script