- \n
- Ubuntu 18.04<\/li>\n
- Root privileges<\/li>\n<\/ul>\n
What we will do?<\/h2>\n
- \n
- Install Java OpenJDK<\/li>\n
- Install and Configure AirSonic<\/li>\n
- Generate New SSL Letsencrypt Certificate<\/li>\n
- Configure Nginx as a Reverse Proxy<\/li>\n
- Configure UFW Firewall<\/li>\n
- Testing<\/li>\n<\/ol>\n
Step 1 – Install Java OpenJDK<\/h2>\n
Airsonic is a Java-based application software, so we need to install Java on the server, and it requires the OpenJDK 1.8x series installation. In this first step, we will install Java OpenJDK from the PPA repository webupd8team.<\/p>\n
Install the ‘software-properties-common’ packages and then add the Java OpenJDK PPA repository.<\/p>\n
Run the following apt commands.<\/p>\n
sudo apt install software-properties-common apt-transport-https -y
sudo add-apt-repository ppa:webupd8team\/java -y<\/p>\nNow install the Java OpenJDK.<\/p>\n
sudo apt install oracle-java8-installer -y<\/p>\n
And after the installation is complete, check the Java OpenJDK version.<\/p>\n
java -version<\/p>\n
Now you will get the Java OpenJDK 1.8 series has been installed on the Ubuntu 18.04 system.<\/p>\n
![\"Install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts.png\" "\\"\\"")
<\/a><\/p>\nStep 2 – Install and Configure Airsonic<\/h2>\n
Airsonic provides different installation packages, for this guide, we will be using the ‘stand-alone WAR installation’.<\/p>\n
Create a new user named ‘airsonic’, and create a new directory ‘\/opt\/airsonic’.<\/p>\n
useradd airsonic
mkdir -p \/opt\/airsonic<\/p>\nNow go to the ‘\/opt\/airsonic’ directory and download the Airsonic ‘.WAR’ package file using wget.<\/p>\n
cd \/opt\/airsonic
wget https:\/\/github.com\/airsonic\/airsonic\/releases\/download\/v10.1.1\/airsonic.war<\/p>\nAnd change the owner of the ‘\/opt\/airsonic’ directory to the ‘airsonic’ user and group.<\/p>\n
chown -R airsonic:airsonic \/opt\/airsonic<\/p>\n
The Airsonic ‘.WAR’ binary package has been downloaded.<\/p>\n
![\"Install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts-1.png\" "\\"\\"")
<\/a><\/p>\nNext, we need to create a new service file for Airsonic, go to the ‘\/etc\/systemd\/system’ directory and create a new service file ‘airsonic.service’.<\/p>\n
cd \/etc\/systemd\/system\/
vim airsonic.service<\/p>\nPaste the following Airsonic service configuration there.<\/p>\n
[Unit] \nDescription=Airsonic Media Server \nAfter=remote-fs.target network.target \nAssertPathExists=\/opt\/airsonic \n \n[Service] \nType=simple \nEnvironment=\"JAVA_JAR=\/opt\/airsonic\/airsonic.war\" \nEnvironment=\"JAVA_OPTS=-Xmx700m\" \nEnvironment=\"AIRSONIC_HOME=\/opt\/airsonic\" \nEnvironment=\"PORT=8080\" \nEnvironment=\"CONTEXT_PATH=\/airsonic\" \nEnvironment=\"JAVA_ARGS=\" \nEnvironmentFile=-\/etc\/sysconfig\/airsonic \nExecStart=\/usr\/bin\/java \\ $JAVA_OPTS \\ -Dairsonic.home=${AIRSONIC_HOME} \\ -Dserver.context-path=${CONTEXT_PATH} \\ -Dserver.port=${PORT} \\ -jar ${JAVA_JAR} $JAVA_ARGS \nUser=airsonic \nGroup=airsonic \n \n[Install] \nWantedBy=multi-user.target<\/pre>\nSave and exit.<\/p>\n
Reload the systemd system and create a new airsonic default configuration file on the ‘\/etc\/default’ directory.<\/p>\n
sudo systemctl daemon-reload
vim \/etc\/default\/airsonic<\/p>\nPaste the following default airsonic configuration there.<\/p>\n
# Set the location of the standalone war to use \nJAVA_JAR=\/opt\/airsonic\/airsonic.war \n \n# Set any java opts separated by spaces \nJAVA_OPTS=-Xmx700m \n \n# Set a different location for the airsonic home. \n# If this path is \/opt\/libresonic or even contains \"libresonic\", \n# the data from a previous libresonic can be used as is (i.e. without \n# renaming libresonic.properties,db\/libresonic*, etc \nAIRSONIC_HOME=\/opt\/airsonic \n \n# Change the port to listen on \nPORT=8080 \n \n# Change the path that is listened to on \nCONTEXT_PATH=\/airsonic \n \n# Add any java args. These are different than JAVA_OPTS in that \n# they are passed directly to the program. The default is empty: \n#JAVA_ARGS= \n \n# Note that there are several settings for spring boot, not explicitly listed \n# here, but can be used in either JAVA_OPTS or JAVA_ARGS. The full list \n# can be found here: \n# https:\/\/docs.spring.io\/spring-boot\/docs\/1.4.5.RELEASE\/reference\/htmlsingle\/#common-application-properties \n# For example to set debug across the board: \n#JAVA_ARGS=--debug \n \n# Or to change the IP address that is listened to: \nJAVA_ARGS=--server.address=127.0.0.1<\/pre>\n
Save and exit.<\/p>\n
Now start the Airsonic service and enable it to launch everytime at system boot.<\/p>\n
systemctl start airsonic
systemctl enable airsonic<\/p>\n![\"Start](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts-2.png\" "\\"\\"")
<\/a><\/p>\nThe airsonic ‘stand-alone’ installation is complete, and now it’s up and running, check it using the netstat command.<\/p>\n
netstat -plntu<\/p>\n
And you will get the default port Airsonic ‘8080’ on the ‘LISTEN’ state, used by the Java Airsonic service.<\/p>\n
![\"Check](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts-3.png\" "\\"\\"")
<\/a><\/p>\nStep 3 – Generate New SSL Letsencrypt Certificate<\/h2>\n
In this tutorial, we will deploy Airsonic under the HTTPS connection of Nginx reverse proxy with the domain name ‘music.hakase-labs.io’.<\/p>\n
And for this step, we will generate the SSL certificates from Letsencrypt. Install the Letsencrypt tool using the following apt command.<\/p>\n
sudo apt install letsencrypt -y<\/p>\n
The Letsencrypt tool has been installed.<\/p>\n
Next, we need to generate the new SSL certificates for the ‘music.hakase-labs.io’ domain using the command below.<\/p>\n
certbot certonly –standalone -d music.hakase-labs.io<\/p>\n
You will be asked for the email address, and it’s used for the renew notification. For the Letsencrypt TOS agreement, type ‘A’ to agree and for the share email address, you can type ‘N’ for No.<\/p>\n
![\"Create](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts-4.png\" "\\"\\"")
<\/a><\/p>\nWhen all is complete, you will get the result as shown below.<\/p>\n
![\"Letsencrypt](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts-5.png\" "\\"\\"")
<\/a><\/p>\nSSL Letsencrypt for the ‘music.hakase-labs.io’ domain has been generated, all certificates located at the ‘\/etc\/letsencrypt\/live\/domain’ directory.<\/p>\n
Step 4 – Install and Configure Nginx as a Reverse proxy<\/h2>\n
In this step, we will install the Nginx web server and configure it as a reverse proxy for the Airsonic software on port 8080.<\/p>\n
Install the Nginx web server using the following apt command.<\/p>\n
sudo apt install nginx -y<\/p>\n
Now go to the ‘\/etc\/nginx’ directory and create a new virtual host file ‘airsonic’.<\/p>\n
cd \/etc\/nginx\/
vim sites-available\/airsonic<\/p>\nPaste the following configuration there.<\/p>\n
server { listen 80; listen [::]:80; server_name music.hakase-labs.io; # enforce https return 301 https:\/\/$server_name$request_uri; \n} \n \nserver { listen 443 ssl; server_name music.hakase-labs.io; ssl_certificate \/etc\/letsencrypt\/live\/music.hakase-labs.io\/fullchain.pem; ssl_certificate_key \/etc\/letsencrypt\/live\/music.hakase-labs.io\/privkey.pem; \n location \/airsonic { proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto https; proxy_set_header X-Forwarded-Host $http_host; proxy_set_header Host $http_host; proxy_max_temp_file_size 0; proxy_pass http:\/\/127.0.0.1:8080; proxy_redirect http:\/\/ https:\/\/; } \n}<\/pre>\nSave and exit.<\/p>\n
Activate the ‘airsonic’ virtual host file and test the configuration.<\/p>\n
ln -s \/etc\/nginx\/sites-available\/airsonic \/etc\/nginx\/sites-enabled\/
nginx -t<\/p>\nMake sure there is no error, then restart the nginx service and enable it to launch everytime at system boot.<\/p>\n
systemctl restart nginx
systemctl enable nginx<\/p>\n![\"Install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts-6.png\" "\\"\\"")
<\/a><\/p>\nThe Nginx web server is now running as a reverse proxy for the Airsonic on port 8080, and it’s running under the https secure connection.<\/p>\n
Check it using netstat command below.<\/p>\n
netstat -plntu<\/p>\n
![\"Check](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts-7.png\" "\\"\\"")
<\/a><\/p>\nStep 5 – Configure UFW Firewall<\/h2>\n
In this tutorial, we will turn on the firewall, and we will be using the UFW firewall for Ubuntu.<\/p>\n
Open the SSH, HTTP and HTTPS service on the UFW firewall list by running commands below.<\/p>\n
ufw allow ssh
ufw allow http
ufw allow https<\/p>\nNow enable the ufw firewall.<\/p>\n
ufw enable<\/p>\n
Type ‘y’ and press Enter to start and enable the UFW firewall.<\/p>\n
And the ufw firewall has been enabled.<\/p>\n
![\"Configure](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts-8.png\" "\\"\\"")
<\/a><\/p>\nStep 6 – Testing<\/h2>\n
Open your web browser and type the Airsonic installation URL on the address bar. Mine is:<\/p>\n
https:\/\/music.hakase-labs.io\/airsonic\/<\/strong><\/em><\/p>\n
Now you will be shown the Airsonic login page.<\/p>\n
![\"Airsonic](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts-9.png\" "\\"\\"")
<\/a><\/p>\nLog in as a default user ‘admin’ with password ‘admin’, and press the ‘Log In’ button.<\/p>\n
And when you logged in, you will see the Airsonic Dashboard.<\/p>\n
– Change Default Password<\/h3>\n
Click on the ‘Change administrator password’ button.<\/p>\n
![\"Change](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts-10.png\" "\\"\\"")
<\/a><\/p>\nNow select the ‘admin’ user and give a mark on the ‘Change password’, then type new admin password and click ‘Save’.<\/p>\n
![\"Admin](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts-11.png\" "\\"\\"")
<\/a><\/p>\nThe default admin password for Airsonic has been changed.<\/p>\n
– Set up Media Folders<\/h3>\n
Back to the terminal shell server, create new media folders manually and change the owner of media folder directory to ‘airsonic’ user.<\/p>\n
mkdir -p \/var\/music
chown -R airsonic:airsonic \/var\/music<\/p>\nNow on the Airsonic admin dashboard, click the ‘Settings’ button and click the ‘Media folders’ tab.<\/p>\n
![\"Configure](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts-12.png\" "\\"\\"")
<\/a><\/p>\nMake sure the default ‘Music’ media folders has been enabled, then click ‘Save’ button.<\/p>\n
Now move to the ‘User’ tab, select the ‘admin’ user and make a check on the ‘Music’ media folder as below.<\/p>\n
![\"User](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts-13.png\" "\\"\\"")
<\/a><\/p>\nThe default ‘Music’ media folder has been enabled, and the ‘admin’ user now has an access to the media folders.<\/p>\n
Below is my Airsonic dashboard after making some changes.<\/p>\n
![\"Airsonic](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts-14.png\" "\\"\\"")
<\/a><\/p>\nThe Airsonic media streamer installation with Nginx as a reverse proxy on Ubuntu 18.04 has been completed successfully.<\/p>\n
Reference<\/h2>\n
\nShare this page:<\/b><\/p>\n
\n
![\"\"](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts-15.png\" "\\"\\"")
<\/a>
\n![\"\"](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts-16.png\" "\\"\\"")
<\/a>
\n![\"\"](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts-17.png\" "\\"\\"")
<\/a>
\n![\"\"](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/07\/how-to-install-airsonic-media-server-on-ubuntu-18-04-lts-18.png\" "\\"\\"")
<\/a>\n<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"Airsonic is free and open source media server. It’s a self-hosted web-based media streamer that provides ubiquitous access to your music, makes it easy to share your music with friends or listen to your music while at work. Airsonic has been created with Java as a full fork of the Subsonic, and designed to handle …<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[36],"tags":[],"class_list":["post-5238","post","type-post","status-publish","format-standard","hentry","category-36"],"_links":{"self":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/posts\/5238","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/comments?post=5238"}],"version-history":[{"count":0,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/posts\/5238\/revisions"}],"wp:attachment":[{"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/media?parent=5238"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/categories?post=5238"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/afaghhosting.net\/blog\/wp-json\/wp\/v2\/tags?post=5238"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
![\"Install](\"https:\/\/www.howtoforge.com\/images\/how_to_install_airsonic_on_ubuntu_1804\/big\/1.png\" "\\"\\"")
<\/a><\/p>\n