Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Linux Install: Recommend not mounting <library_path> directly #135

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Linux Install: Recommend not mounting <library_path> directly #135

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions content/en/docs/Installation/linux.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@ aliases:

The following steps have been tested on Ubuntu 18.04 and should work on all version 16.04 and above as well as other Debian based distros. Throughout these instructions the commands will have placeholders for the user (`<user>`) and group (`<group>`) you want to run Navidrome under and the music folder path (`<library_path>`). If you are using an existing media library ensure the user has permissions to the media library.

If `<library_path>` is not on the root filesystem, it is recommended to not mount the folder containing your music directly, but its parent directory. For example, if you mount the disk/network share in `/mnt/navidrome`, create a subdirectory `/mnt/navidrome/library` to store your music. This ensures that if the disk/network share is not mounted for any reason, and Navidrome scans the library, you will not lose your playlist contents, favourites, and play counts. The reason for this is that if Navidrome scans the library, and `<library_path>` does not exist, the scan will fail and your database will not be changed. If, however, `<library_path>` does exist but is empty, then Navidrome will delete all songs from the database. If this occurs, playlist contents, favourites, and play counts are lost since these are deleted when a song is deleted from the database. If you must directly mount the folder containing your music, you can prevent Navidrome from starting if `<library_path>` is empty by adding `AssertDirectoryNotEmpty=<library_path>` in the `[Unit]` section of `/etc/systemd/system/navidrome.service`.

### Update and Install Prerequisites

Ensure your system is up to date and install [ffmpeg](https://ffmpeg.org/download.html).
Expand Down