If you’d prefer not to use a Tomcat container, you can also run Airsonic as a standalone application.
Note that, in that case, airsonic will available at
http://localhost:8080 (and not
In order to install and run Airsonic, you will need:
Download the latest Airsonic .war package from the download page, or with the command below:
Download and import
Andrew DeMaria public key:
gpg --keyserver keyserver.ubuntu.com --recv 0A3F5E91F8364EDF
Download the signed checksums file and verify the previously download .war package:
wget https://github.com/airsonic/airsonic/releases/download/v10.5.0/artifacts-checksums.sha.asc gpg --verify artifacts-checksums.sha.asc sha256sum -c artifacts-checksums.sha.asc
Create the Airsonic directory and assign ownership to the user that will run Airsonic:
sudo mkdir /var/airsonic/ sudo chown -R $USER:$GROUP /var/airsonic/
Now you can simply run java against the airsonic.war package:
java -jar airsonic.war
Airsonic should be running at http://localhost:8080 if installed locally, replace
localhost with your server IP address if installed remotely.
To go a bit further than just running the airsonic manually, one can setup integration with Systemd. Systemd is an init system for most linux systems. It allows one to run airsonic on boot. These steps below were done on a Fedora host, however the steps should be similar for other Linux distributions.
By following these systemd setup instructions, Airsonic will be available at
Setup dedicated airsonic user:
Setup Airsonic data dir:
mkdir /var/airsonic chown airsonic /var/airsonic
Download the war:
wget https://github.com/airsonic/airsonic/releases/download/v10.5.0/airsonic.war --output-document=/var/airsonic/airsonic.war
Setup systemd service:
wget https://raw.githubusercontent.com/airsonic/airsonic/master/contrib/airsonic.service -O /etc/systemd/system/airsonic.service systemctl daemon-reload systemctl start airsonic.service systemctl enable airsonic.service wget https://raw.githubusercontent.com/airsonic/airsonic/master/contrib/airsonic-systemd-env -O /etc/sysconfig/airsonic
NOTE: On Debian systems you need to replace
Review/Modify any startup settings in /etc/sysconfig/airsonic.