Initial Setup and Configuration

In this guide, we'll be setting up Airsonic for the first time. This assumes that your music library is in ~/media/Music. We'll be doing the following steps:

  1. Setting an admin password
  2. Adding music folders
  3. 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 Home to show the welcome message again.
  • Click on step 2, which is Set up media folders

  • In this step, you need to get the absolute path of your media folder.
  • To do that, login to your slot’s SSH terminal, navigate to your media folder and print the work 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 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 /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 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 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 access with
  • At the end of the page, you need to add a username, email (ou can make up any email here) and your set password.
  • Once that’s all done, just click save.