User Tools

Site Tools


  • airsonic
  • Jonathan Haack
  • Haack's Networking


Folks these days would love to be able to stream their own music as effortlessly as Spotify, Apple Music, and other proprietary services, but often do not know how to do so. This tutorial is designed to provide a free software solution for music and media streaming. Before beginning, make sure to setup LAMP/TLS on Debian first, and you can use Apache Survival. I used the AirSonic documentation and some forums, etc., to set up a reverse proxy (on an alternate port 8081) to run an AirSonic media server instance. I should also mention that the media directories I am using are simultaneously hosted within a Nextcloud instance on the same localhost. The two services work in unison flawlessly and here are my findings and instructions:

sudo apt install tomcat9
cd /etc/tomcat9/
nano server.xml

Change port to needed port (8081)

mv airsonic.war /var/airsonic/
gpg --keyserver --recv 0A3F5E91F8364EDF
gpg --verify artifacts-checksums.sha.asc
sha256sum -c artifacts-checksums.sha.asc
sudo rm /var/lib/tomcat9/webapps/airsonic.war
sudo rm -R /var/lib/tomcat9/webapps/airsonic/
sudo rm -R /var/lib/tomcat9/work/*
sudo mkdir /var/airsonic/
sudo chown -R $USER:$USER /var/airsonic/
cd /var/airsonic/
ln -s /home/nextclouddata/username/files/Music/Masters music
sudo systemctl stop tomcat9.service
java -jar -Dserver.port=8081 /var/airsonic/airsonic.war

Once you detach from the screen, this will remain running until reboot. Navigate to:


Or, if you need to set up your instance for external access and already set up LAMP or FEMP or something equivalently secure, then you would navigate to:

Personally, I do leverage external access and I use apache and these virtual host configurations: Air Sonic Virtual Host Configuration Examples. Also, I will organize this later, but here is how to make sure the transcoder is working:

mkdir /var/airsonic/transcode
cd transcode/
ln -s /usr/bin/ffmpeg
chown -h user:user ffmpeg
ls -alh
<lrwxrwxrwx 1 user user   15 mai    4 19:57 ffmpeg -> /usr/bin/ffmpeg>

Peace all … oemb1905 #freesoftware #gnulinux #debian

oemb1905 2021/06/26 22:39

computing/airsonic.txt · Last modified: 2021/06/26 22:40 by oemb1905