Guidance on usage: Airsonic Advanced Server on Ubuntu 20.04

Configuration and connection Airsonic Advanced Server on Ubuntu 20.04

  1. To start the server, run the VM through Azure Portal
  1. For the connection to the server, you should know the IP address of the VM. You can find it in the personal account of Azure. (You need to select the virtual machine from the list. By clicking the item “Overview”, your IP is displayed in the line “Public IP Address”).
  1. To work, you must open port 8080 (TCP) in the network properties in the Azure firewall
  1. After starting the VM, you can go to the main page. To do this, go to the following address http://*vm_ip*:8080/airsonic
  1. The authorization page will open. To log in as an administrator, use the username admin and the password admin
  1. After authorization, the main page will open. First, it is recommended to change the password for the account. To do this, click on “Change administrator password”
  1. Check the box next to “Add credentials”, and enter the new password in the “New Password” and “Confirm Password” fields.
  1. To add audio to the library, you need to upload music to the server. Connect to a VM.
    1. With OpenSSH

In the Windows 10 operating system (starting with version 1809 ), an OpenSSH client is available, with which you can connect to Linux servers via SSH. If Windows 10 is suitable and the OpenSSH client is installed, you can start connecting via SSH. To do this, launch a standard Windows command prompt and enter the command “ssh user@*vm_ip*” (1), where “user” is the username that was specified while creating the virtual machine and “*vm_ip*” is the VM IP address.

Then type “Yes” (2) and enter a password (3) that was specified while creating the virtual machine.

  1. With the PuTTy application 

To do this you need the PuTTy application to connect via ssh. You can download it at the following link – Download

Run Putty, enter the VM address in the “Host” field (1), and click “Open” (2) to connect.

In the opened console you will need to enter a username (1) and password (2) that were specified while the VM was being created (you’ll not see the password in the console while entering it). 

  1. Create a folder where we will upload the music. To do this, enter the command

$ cd /var

$ sudo mkdir music

And a command to go to the created folder

$ cd music

  1. Now you can upload audio files to this folder. Files should be grouped into folders as follows:


Therefore, we will create several folders with the following command (inside the music folder):

$ sudo mkdir -p artist/album

and go to this folder with the command:

$ cd artist/album

To download a track via a direct link, you can use the following command (while inside the album folder)

$ sudo wget -O %file_name% %link_to music%

For example:
$ sudo wget -O Omen.mp3 ‘

  1. Now you need to scan the folder for added files. To do this, go to settings, and click the “Scan media folders now” button.
  1. Also, permit the user admin access to the folder where we downloaded the music. To do this, go to the settings in the “Users” section.
  1. Select the “admin” user, check the box next to the music folder, and press <Save>.
  1. If you did everything right, then on the “Home” page your tracks should appear, which you can play directly from the browser (if the prompt is still displayed, then just click on “Don’t show this again” in the third paragraph.

More information on setting up and working with Airsonic can be found here.
First start guide

How to configure Airsonic