Initial Setup and Configuration
In this guide, we'll be doing the following initial setup steps:
- Setting an admin password
- Adding music folders
- Add a limited user
Initial Setup
Setting an administrator password
- After installation, click Connect under Airsonic
- The 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 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 Users section. Find the Change password checkbox.
- Tick it and change it to a 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 Setup 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
- Navigate to your media folder.
- In this example, my Music folder is in a mount named Media.
- Navigate to the Music folder by typing
cd >folder-name-here<
until you reach 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. 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
- MusicBrainz Picard
- Lidarr
Adding a Limited user
- Accessing and playing your library using a limited user is recommended than using your admin account because it prevents >expound here<
- 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 (you can make a fake email here) and your set password.
- Once that’s all done, just click save.