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:
- 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
- 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
andcd Music
- In this case, I'll do
- Now, do
pwd
to show and copy the full path of that folder.
- In this example, my Music folder is in
- Login to your slot’s SSH terminal
- 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 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 (any fake email is accepted here) and your set password.
- Once that’s all done, just click save.