Skip to main content

Initial Setup

  • Airsonic Advanced Isis a free, full-featured, stable, Java-web-based self-hosted media serverstreamer, forkedproviding fromubiquitous Subsonic and Libresonic, open-source, and community-driven. Some features of this app are:

    • Designedaccess to handleyour extensivemusic.
    • Use it to share your music collections
      • with
    • It works for any audiofriends, or videoto formatlisten thatto your own music while at work. You can stream overto HTTP
      • multiple
    • Supportplayers simultaneously, for on-the-flyinstance transcodingto one player in your kitchen and streaminganother of virtually any audio format
    • Integrated Podcast Receiver
    • Built-in sharingyour options
      • living
    • Compatible with Subsonic appsroom.

    For more information about this app, you may visit this link.

    InitialGeneral SetupInformation

    This

      assumes
    • Airsonic thatAdvanced will have the following Media folders already set-up for you by default:
    Music - /home/your_username/media/Music
Podcasts - /home/your_username/media/Podcasts
    • You can add all your music libraryand ispodcasts into ~/media/Music.the We'llrelevant directories. They will be doingscanned theeveryday followingat steps:

      3:00
        CET
      • Addingby music folders
      • Add a limited userdefault.

      Setting Additional Media Folders

      • Click HomeGo to showSettings the-> welcome message again.

      • Click on step 2, which is Set up mediaMedia folders

      • In this step, you need to get the absolute path of your media folder.

      • To do that, log in to your slot's SSH terminal, navigate to your media folder and print the working directory (pwd) of that folder to get its absolute path.

        • Login to your slot's SSH terminal
          • For more information on how to login to your services's SSH terminal, refer to this guide.
        • Navigate to your media folder.
          • In this example, my Music folder is in ~/media
          • To list the directories, do ls
          • Navigate to the Music folder by typing cd >folder-name-here<
            • In this case, I'll do cd media and cd Music
          • Now, do pwd to show and copy the full path of that folder.

      • On the Media folders section, replaceyou will see a subsection Add media folder.

      • You can input any string for the /musicName withfield.
      • For the fullFolder field, enter the path of your music folder. In this case, /home1/usbdocs/media/Music isto the fulldirectory path.you Scrollwish downto andadd.
      • Example:
      Name: My Cover Songs 
Folder: /home/your_username/media/my-cover-songs
      • Click on the Save button at the bottom.
      • Then, click save when done.

      • Now, Clickon Scan Media folders now button to initialize a full scan of the folder. This will take a while, depending on the size of the library.

      Media Folder Structure Recommendations

      • We recommend this folder structure for Airsonic to properly detect and organize the library.
      Music
    Artist 1
        Album 1 (year)
            Artist 1 - Album 1 - Track 1.flac
    Artist 2
        Album 2 (Year)
        Album 3 (Year)
      • You can automate this setup by utilizing the following apps

      Adding a Limited User

      • Accessing and playing your library using a limited user is recommended thanover using your admin account because it prevents unauthorized or accidental changes to your Airsonic instance.
      • To add a limited user, Go to Settings ⇾ Users
      • Under the dropdown menu, select --New user--
      • Then check the permissions needed.
        • Since this is a limited account, DO NOT tick administrativeAdministrative user
      • Check all the media folders you want to access
      • At the end of the page, you need to add a username, email (you can make up any email here), and your set password.
      • Once that's all done, click on saveSave.
Back to top