Skip to main content

Initial Setup

InAirsonic Is a free, full-featured, stable, Java-based self-hosted media server forked from Subsonic and Libresonic, open-source, and community-driven. Some features of this guide,app we'llare:

be
    setting
  • Designed upto Airsonichandle extensive music collections
  • It works for theany firstaudio time.or video format that can stream over HTTP
  • Support for on-the-fly transcoding and streaming of virtually any audio format
  • Integrated Podcast Receiver
  • Built-in sharing options
  • Compatible with Subsonic apps

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

Initial Setup

This assumes that your music library is in ~/media/Music. We'll be doing the following steps:

  1. Setting an admin password
    • Adding music folders
    • Add a limited user

Initial Setup

Setting an administrator password

  • After installation, click Connect under Airsonic
  • Airsonic login appears. Login first using the default credentials which are the following:
Username: admin
Password: admin

  • Once logged in, you’ll be greeted with the following welcome message. We’ll be doing step 1 which is changing the administrator password.
  • Click Change administrator password

  • You’ll be taken to the settings under the Users section. Find the Change password checkbox.

  • Tick it and change it to your desired password.

  • Once that’s done, click Save.

Setting Media Folders

  • Click 

    Click Home to show the welcome message again.

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

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

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

      • Login to your slot’slot's SSH terminal
        • For more information on how to login to your seedbox'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, replace the the /music with the full path of your music folder. In this case, /home1/usbdocs/media/Music is the full path. Scroll down and click save when done.

    • Now, Click Scan Media folders now to initialize a full scan of the folder. This will take a whilewhile, 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 than using your admin account because it prevents any unauthorized and/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 administrative user
    • Check all the media folders you want to access with
    • At the end of the page, you need to add a username, email (ouyou can make up any email here), and your set password.
    • Once that’that's all done, just click save.

    • Back to top