### Start and Enable Navidrome Service

Source: https://www.navidrome.org/docs/installation/ubuntu-linux

Enable the Navidrome service to start on boot and start it immediately using systemctl.

```bash
sudo systemctl enable --now navidrome
```

--------------------------------

### Install Navidrome using apt

Source: https://www.navidrome.org/docs/installation/ubuntu-linux

Install the downloaded .deb package using the apt command. This method automatically handles and installs any necessary dependencies, such as ffmpeg.

```bash
sudo apt install ./navidrome_0.XX.X_linux_amd64.deb
```

--------------------------------

### Install, Start, and Status Navidrome Service with WinSW

Source: https://www.navidrome.org/docs/installation/windows

Commands to install, start, and check the status of the Navidrome service using WinSW, referencing the previously defined XML configuration file.

```bash
winsw install navidrome.xml
winsw start navidrome.xml
winsw status navidrome.xml
```

--------------------------------

### Install and Start Navidrome Service with Shawl

Source: https://www.navidrome.org/docs/installation/windows

Use Shawl to add Navidrome as a service and then start it. Ensure you are running this from an administrator command prompt and use absolute paths for Navidrome's executable and configuration file.

```bash
shawl add --name Navidrome -- "C:\Services\navidrome\navidrome.exe" -c "C:\Services\navidrome\navidrome.toml"
sc start Navidrome
```

--------------------------------

### MPV Audio Devices on Linux Example

Source: https://www.navidrome.org/docs/usage/features/jukebox

An example output showing detected audio devices on a Linux system when using `mpv --audio-device=help`.

```text
List of detected audio devices:
  'auto' (Autoselect device)
  'alsa' (Default (alsa))
  'alsa/jack' (JACK Audio Connection Kit)
  'alsa/default:CARD=Headphones' (bcm2835 Headphones, bcm2835 Headphones/Default Audio Device)

  ... 

  'jack' (Default (jack))
  'sdl' (Default (sdl))
  'sndio' (Default (sndio))


```

--------------------------------

### MPV Audio Devices on macOS Example

Source: https://www.navidrome.org/docs/usage/features/jukebox

An example output showing detected audio devices on a macOS system when using `mpv --audio-device=help`.

```text
List of detected audio devices:
  'auto' (Autoselect device)
  'coreaudio/AppleGFXHDAEngineOutputDP:10001:0:{D109-7950-00005445}' (BenQ EW3270U)
  'coreaudio/AppleUSBAudioEngine:Cambridge Audio :Cambridge Audio USB Audio 1.0:0000:1' (Cambridge Audio USB 1.0 Audio Out)
  'coreaudio/BuiltInSpeakerDevice' (MacBook Pro-Lautsprecher)


```

--------------------------------

### Install System Dependencies

Source: https://www.navidrome.org/docs/installation/linux

Update package lists, upgrade existing packages, and install necessary dependencies like vim and ffmpeg.

```bash
sudo apt update
sudo apt upgrade
sudo apt install vim ffmpeg
```

--------------------------------

### Install Navidrome using dpkg and apt -f

Source: https://www.navidrome.org/docs/installation/ubuntu-linux

Alternatively, install the package using dpkg and then use 'apt install -f' to resolve any missing dependencies. This is a two-step process.

```bash
sudo dpkg -i ./navidrome_0.XX.X_amd64.deb
sudo apt install -f
```

--------------------------------

### Install Navidrome using Package on FreeBSD

Source: https://www.navidrome.org/docs/installation/freebsd

Installs Navidrome from a binary package using the pkg tool. Follow on-screen instructions to complete.

```bash
pkg install navidrome
```

--------------------------------

### Enable Navidrome to Start on System Boot

Source: https://www.navidrome.org/docs/installation/freebsd

Configures Navidrome to start automatically when the system boots by enabling the service in /etc/rc.conf.

```bash
sysrc navidrome_enable="YES"
```

--------------------------------

### Complete Jukebox Configuration Example

Source: https://www.navidrome.org/docs/usage/features/jukebox

A comprehensive example of the Jukebox configuration section in `navidrome.toml`, including enabling the mode, defining devices, and setting the default device.

```toml
# Enable/Disable Jukebox mode
Jukebox.Enabled = true

# List of registered devices, syntax:
#  "symbolic name " - Symbolic name to be used in UI's
#  "device" - MPV audio device name, do mpv --audio-device=help to get a list

Jukebox.Devices = [
    # "symbolic name " "device"
    [ "internal",     "coreaudio/BuiltInSpeakerDevice" ],
    [ "dac",          "coreaudio/AppleUSBAudioEngine:Cambridge Audio :Cambridge Audio USB Audio 1.0:0000:1" ]
]

# Device to use for Jukebox mode, if there are multiple entries above.
# Using device "auto" if missing
Jukebox.Default = "dac"

```

--------------------------------

### Install Navidrome Package

Source: https://www.navidrome.org/docs/installation/linux

Installs the downloaded .deb package using either apt or dpkg.

```bash
sudo apt install ./navidrome_0.XX.X_linux_amd64.deb
```

```bash
sudo dpkg -i ./navidrome_0.XX.X_amd64.deb
sudo apt install -f
```

--------------------------------

### View Playback Server Logs

Source: https://www.navidrome.org/docs/usage/features/jukebox

Example log output showing the initialization of the playback server and detected audio devices.

```text
INFO[0000] Starting playback server
INFO[0000] 4 audio devices found
INFO[0000] Using default audio device: dac
```

--------------------------------

### View Docker Logs

Source: https://www.navidrome.org/docs/getting-started

Check the logs for a Docker installation to verify Navidrome started successfully.

```bash
docker logs navidrome
```

--------------------------------

### Enable Navidrome on Startup

Source: https://www.navidrome.org/docs/installation/linux

Configure the Navidrome service to start automatically when the system boots up.

```bash
sudo systemctl enable navidrome.service
```

--------------------------------

### Update System and Install Dependencies

Source: https://www.navidrome.org/docs/installation/ubuntu-linux

Updates the package list and installs necessary dependencies like ffmpeg.

```bash

sudo apt update
sudo apt upgrade
sudo apt install vim ffmpeg

```

--------------------------------

### Navidrome Configuration File Example (Windows)

Source: https://www.navidrome.org/docs/usage/configuration/options

Example of a navidrome.toml configuration file for Windows, specifying log level, scanner schedule, transcoding cache size, music folder, and FFmpeg path.

```toml
# This is just an example! Please see available options to customize Navidrome for your needs at
# https://www.navidrome.org/docs/usage/configuration/options/#available-options

LogLevel = 'DEBUG'
Scanner.Schedule = '@every 24h'
TranscodingCacheSize = '150MiB'

# IMPORTANT: Use single quotes for paths in Windows

MusicFolder = 'C:\Users\JohnDoe\Music'

# Set this to the path of your ffmpeg executable

FFmpegPath = 'C:\Program Files\ffmpeg\bin\ffmpeg.exe'
```

--------------------------------

### Build Navidrome on Unix-based Systems

Source: https://www.navidrome.org/docs/installation/build-from-source

Use these commands to clone the repository, install build dependencies, and build the Navidrome executable on most Unix-like systems. Ensure Go 1.24+ and Node 24+ are installed, along with the TagLib library.

```bash
git clone https://github.com/navidrome/navidrome
cd navidrome
make setup        # Install build dependencies
make build        # Build UI and server, generates a single executable
```

--------------------------------

### Start and Check Navidrome Service Status on FreeBSD

Source: https://www.navidrome.org/docs/installation/freebsd

Starts the Navidrome service and checks its status. Navidrome defaults to listening on 127.0.0.1:4533.

```bash
service navidrome onestart
service navidrome onestatus
```

--------------------------------

### Navidrome Configuration File Example (Unix-based)

Source: https://www.navidrome.org/docs/usage/configuration/options

Example of a navidrome.toml configuration file for Unix-based systems, specifying log level, scanner schedule, transcoding cache size, and music folder.

```toml
# This is just an example! Please see available options to customize Navidrome for your needs at
# https://www.navidrome.org/docs/usage/configuration/options/#available-options

LogLevel = 'DEBUG'
Scanner.Schedule = '@every 24h'
TranscodingCacheSize = '150MiB'
MusicFolder = '/mnt/music'
```

--------------------------------

### Build and Install Navidrome from Ports on FreeBSD

Source: https://www.navidrome.org/docs/installation/freebsd

Builds and installs Navidrome from source using the ports tree. Ensure your ports tree is up-to-date before running. This process may take several minutes.

```bash
cd /usr/ports/multimedia/navidrome
make install
```

--------------------------------

### Specify Configuration File (Windows)

Source: https://www.navidrome.org/docs/usage/configuration/options

Example of how to specify a custom configuration file path using the --configfile option in Windows.

```bash
C:\> navidrome --configfile "c:\User\JohnDoe\navidrome.toml"
```

--------------------------------

### Start Navidrome Service

Source: https://www.navidrome.org/docs/installation/ubuntu-linux

Reloads the systemd daemon and starts the Navidrome service.

```bash

sudo systemctl daemon-reload
sudo systemctl start navidrome.service
sudo systemctl status navidrome.service

```

--------------------------------

### Navidrome Configuration File Example (macOS)

Source: https://www.navidrome.org/docs/usage/configuration/options

Example of a navidrome.toml configuration file for macOS, specifying log level, scanner schedule, transcoding cache size, music folder, and FFmpeg path.

```toml
# This is just an example! Please see available options to customize Navidrome for your needs at
# https://www.navidrome.org/docs/usage/configuration/options/#available-options

LogLevel = 'DEBUG'
Scanner.Schedule = '@every 24h'
TranscodingCacheSize = '150MiB'
MusicFolder = '/Users/JohnDoe/Music'

# This is the default path for Homebrew installed ffmpeg

FFmpegPath = '/opt/homebrew/bin/ffmpeg'
```

--------------------------------

### Enable Navidrome on Startup

Source: https://www.navidrome.org/docs/installation/ubuntu-linux

Configures the Navidrome service to start automatically on system boot.

```bash

sudo systemctl enable navidrome.service

```

--------------------------------

### Install Compilers for Navidrome Build

Source: https://www.navidrome.org/docs/developers/dev-environment

Installs the necessary C and C++ compilers required for building Navidrome within your WSL environment.

```bash
sudo apt install gcc g++
```

--------------------------------

### Set Music Folder via Command Line (Windows)

Source: https://www.navidrome.org/docs/usage/configuration/options

Example of setting the MusicFolder option using a command-line argument in Windows.

```bash
C:\> navidrome --musicfolder "c:\User\JohnDoe\Music"
```

--------------------------------

### Install Navidrome Service with NSSM (Command Line)

Source: https://www.navidrome.org/docs/installation/windows

Configure and install the Navidrome service using NSSM commands directly from the command line. This includes setting the application path, display name, user credentials, and log file rotation.

```bash
nssm install Navidrome "C:\Services\navidrome\navidrome.exe"
nssm set Navidrome AppDirectory "C:\Services\navidrome\"
nssm set Navidrome DisplayName Navidrome
nssm set Navidrome ObjectName "username" "password"
nssm set Navidrome AppStdout "C:\Services\navidrome\navidrome.log"
nssm set Navidrome AppStderr "C:\Services\navidrome\navidrome.log"
nssm set Navidrome AppRotateFiles 1
nssm set Navidrome AppRotateSeconds 86400
nssm set Navidrome AppRotateBytes 10240

# Start the service
sc start Navidrome
```

--------------------------------

### Install Navidrome Service with NSSM (GUI)

Source: https://www.navidrome.org/docs/installation/windows

Install the Navidrome service using NSSM's interactive GUI. This method allows you to configure service properties like the executable path, user account, and logging through a graphical interface.

```bash
nssm install Navidrome
```

--------------------------------

### Example App Metadata Configuration

Source: https://www.navidrome.org/docs/developers/adding-apps

This YAML file defines the metadata for a client application, including its name, URL, supported platforms, API, description, and screenshots. It also shows optional fields like repository URL and keywords.

```yaml
name: My Music App
url: https://example.com/my-app
repoUrl: https://github.com/example/my-app  # Optional - used for release tracking
# isOpenSource: false  # Uncomment if repo exists but source code is not public

platforms:
  android:
    store: https://play.google.com/store/apps/details?id=com.example.myapp
  ios:
    store: https://apps.apple.com/app/my-app/id123456789
  web: true
  linux: true

api: OpenSubsonic

description: A beautiful music player with offline support and gapless playback.

screenshots:
  # This is the image shown in the main catalog page. Must not be a logo or icon
  thumbnail: thumbnail.webp
  gallery:
    - screen1.webp
    - screen2.webp

keywords:
  - dlna
  - chromecast
  - carplay
  - android auto


```

--------------------------------

### Specify Configuration File (Unix-based)

Source: https://www.navidrome.org/docs/usage/configuration/options

Example of how to specify a custom configuration file path using the --configfile option in Unix-based systems.

```bash
$ navidrome --configfile "/home/johndoe/navidrome.toml"
```

--------------------------------

### Get Navidrome CLI Help

Source: https://www.navidrome.org/docs/usage/admin/cli

Use the built-in help command to view all available commands and global flags. You can also get help for specific commands or subcommands.

```bash
navidrome --help
```

```bash
navidrome <command> --help
navidrome <command> <subcommand> --help
```

--------------------------------

### Set Music Folder via Command Line (Unix-based)

Source: https://www.navidrome.org/docs/usage/configuration/options

Example of setting the MusicFolder option using a command-line argument in Unix-based systems.

```bash
$ navidrome --musicfolder "/mnt/music"
```

--------------------------------

### Set Music Folder via Command Line (macOS)

Source: https://www.navidrome.org/docs/usage/configuration/options

Example of setting the MusicFolder option using a command-line argument in macOS.

```bash
$ navidrome --musicfolder "/User/JohnDoe/Music"
```

--------------------------------

### Specify Configuration File (macOS)

Source: https://www.navidrome.org/docs/usage/configuration/options

Example of how to specify a custom configuration file path using the --configfile option in macOS.

```bash
$ navidrome --configfile "/User/JohnDoe/navidrome.toml"
```

--------------------------------

### Multi-Valued ARTISTS Tag Example

Source: https://www.navidrome.org/docs/usage/library/tagging

This example demonstrates how to use multi-valued ARTISTS tags in FLAC/Vorbis comments to explicitly list each artist. This is the preferred method for handling collaborations as it allows Navidrome to clearly distinguish and organize individual artists.

```text
ARTISTS=Alice
ARTISTS=Bob
```

--------------------------------

### Manage Navidrome Service

Source: https://www.navidrome.org/docs/installation/macos

Commands to load, start, and stop the Navidrome service using launchctl.

```bash
launchctl load ~/Library/LaunchAgents/navidrome.plist
```

```bash
launchctl start navidrome
```

```bash
launchctl stop navidrome
```

--------------------------------

### Playlist sidecar image structure

Source: https://www.navidrome.org/docs/usage/library/artwork

Example showing a playlist file and its corresponding sidecar image file.

```text

Playlists/
├── My Playlist.m3u
└── My Playlist.jpg          ← sidecar image

```

--------------------------------

### Caddy Configuration with Authentik

Source: https://www.navidrome.org/docs/getting-started/extauth-quickstart

Example Caddyfile configuration for reverse proxying Navidrome with Authentik for authentication. It bypasses authentication for /share/ and /rest/ endpoints.

```caddy
example.com {
   # Remove any client-supplied user header
   request_header -Remote-User

   # Authentik output endpoint
   reverse_proxy /outpost.goauthentik.io/* http://authentik:9000

   # Protect everything except share and subsonic endpoints
   @protected not path /share/* /rest/*
   forward_auth @protected http://authentik:9000 {
      uri /outpost.goauthentik.io/auth/caddy
      copy_headers X-Authentik-Username>Remote-User
   }

   # Forward everything to Navidrome
   reverse_proxy navidrome:4533
}
```

--------------------------------

### Check MPV Version

Source: https://www.navidrome.org/docs/usage/features/jukebox

Verify that MPV is installed and check its version. Ensure it meets the minimum requirements for IPC support (0.7.0 for Linux/macOS, 0.17.0 for Windows).

```bash
$ mpv --version

```

--------------------------------

### Run Navidrome CLI Commands with Docker

Source: https://www.navidrome.org/docs/usage/admin/cli

Start a temporary Docker container to run CLI commands, ensuring it shares the same mounts, environment variables, and configuration as your main Navidrome instance. Align image tag, volumes, and environment variables with your running instance for consistency.

```bash
docker run --rm \
  --user $(id -u):$(id -g) \
  -v /path/to/music:/music:ro \
  -v /path/to/data:/data \
  --env-file /path/to/navidrome.env \
  -e ND_CONFIGFILE=/data/navidrome.toml \
  deluan/navidrome:latest \
  user list
```

--------------------------------

### Example .ndignore Syntax

Source: https://www.navidrome.org/docs/usage/library/exclude-content

Use .ndignore files to specify patterns for content exclusion. Supports comments, file patterns, folder paths, and negation rules. Place this file in the parent folder of your library for global rules.

```ignore
# .ndignore supports comments starting with '#'

# Ignore all .flac
*.flac

# ignore specific folders
/untagged/
/unsorted/

# Negate the .flac ignore rule for a favorite album. 
!/thursday/taking-inventory-of-a-frozen-lake/*.flac
```

--------------------------------

### Ideal Tagging for FLAC/Vorbis Comments

Source: https://www.navidrome.org/docs/usage/library/tagging

This example demonstrates the ideal way to tag multiple artists using multi-valued tags in FLAC or Vorbis comment formats. It ensures each artist is recognized distinctly.

```text
TITLE=Sunshine
ARTIST=Alice feat. Bob
ARTISTS=Alice
ARTISTS=Bob
ALBUM=Brighter Days
ALBUMARTIST=Alice
TRACKNUMBER=7

```

--------------------------------

### Remove Manual Installation

Source: https://www.navidrome.org/docs/installation/linux

Stops the service and removes existing manual installation files before migrating to a package-based setup.

```bash
sudo systemctl stop navidrome.service
```

```bash
sudo rm -rf /opt/navidrome
```

--------------------------------

### Create Navidrome Directories

Source: https://www.navidrome.org/docs/installation/ubuntu-linux

Sets up the required directory structure for the executable and data storage with appropriate ownership.

```bash

sudo install -d -o <user> -g <group> /opt/navidrome
sudo install -d -o <user> -g <group> /var/lib/navidrome

```

--------------------------------

### Install Navidrome as a Service

Source: https://www.navidrome.org/docs/usage/admin/cli

Installs Navidrome as an operating system service. This command is part of the service management subcommands.

```bash
navidrome svc install
```

--------------------------------

### Start and Check Navidrome Service Status

Source: https://www.navidrome.org/docs/usage/admin/cli

Starts the Navidrome service and then checks its current status. These are common commands for managing the Navidrome OS service.

```bash
navidrome svc start
navidrome svc status
```

--------------------------------

### Remove Existing Navidrome Installation

Source: https://www.navidrome.org/docs/installation/ubuntu-linux

Remove the files associated with a manually installed Navidrome instance. Ensure your music library and configuration files are not deleted.

```bash
sudo rm -rf /opt/navidrome
```

--------------------------------

### Build Navidrome on FreeBSD

Source: https://www.navidrome.org/docs/installation/build-from-source

On FreeBSD systems, use 'gmake' instead of 'make' for setting up build dependencies and compiling Navidrome. This ensures compatibility with the system's build tools.

```bash
git clone https://github.com/navidrome/navidrome
cd navidrome
gmake setup        # Install build dependencies
gmake build        # Build UI and server, generates a single executable
```

--------------------------------

### Configure Backup Settings with Environment Variables

Source: https://www.navidrome.org/docs/usage/admin/backup

Configure backup path, schedule, and count using environment variables. Ensure volumes are correctly mapped in your Docker Compose file.

```yaml
environment:
  ND_BACKUP_PATH: /backup
  ND_BACKUP_SCHEDULE: "0 0 * * *"
  ND_BACKUP_COUNT: 7
volumes:
  - ./data:/data
  - ./backup:/backup

```

--------------------------------

### Manage Navidrome Service

Source: https://www.navidrome.org/docs/installation/linux

Commands to enable, start, and monitor the Navidrome service status.

```bash
sudo systemctl enable --now navidrome
```

```bash
sudo systemctl status navidrome
sudo journalctl -u navidrome -f
```

--------------------------------

### File Organization for Multiple Libraries

Source: https://www.navidrome.org/docs/usage/features/multi-library

Organize your music into separate root folders for each library. Ensure the Navidrome user has read access to all library folders.

```bash
/music/main/           # Default library (MusicFolder)
├── Artist 1/
├── Artist 2/
└── ...

/music/audiobooks/     # Audiobooks library
├── Author 1/
├── Author 2/
└── ...

/other_path/lossless/       # High-quality library
├── Artist 1/
├── Artist 2/
└── ...


```

--------------------------------

### Update System Packages

Source: https://www.navidrome.org/docs/installation/linux

Updates the local package index and upgrades installed packages to the latest versions.

```bash
sudo apt update
sudo apt upgrade
```

--------------------------------

### Get Help for Navidrome User Commands

Source: https://www.navidrome.org/docs/usage/admin/cli

Displays help information for the Navidrome user administration commands.

```bash
navidrome user --help
```

--------------------------------

### Create an Admin User

Source: https://www.navidrome.org/docs/usage/admin/cli

Creates a new user with administrative privileges. Specify the username, email, and use the `--admin` flag.

```bash
navidrome user create --username alice --email alice@example.com --admin
```

--------------------------------

### Navidrome Configuration File

Source: https://www.navidrome.org/docs/installation/linux

Create a basic Navidrome configuration file specifying the music library path. For more options, refer to the configuration documentation.

```toml
MusicFolder = "<library_path>"
```

--------------------------------

### Stop Navidrome Service

Source: https://www.navidrome.org/docs/installation/ubuntu-linux

Before removing an existing Navidrome installation or performing maintenance, stop the running service to prevent conflicts.

```bash
sudo systemctl stop navidrome.service
```

--------------------------------

### Configure Navidrome Plugins via Configuration File

Source: https://www.navidrome.org/docs/usage/features/plugins

Use the [Plugins] section in your configuration file to enable and customize plugin behavior.

```toml
[Plugins]
Enabled = true
Folder = "/path/to/plugins"    # Optional: custom plugins folder
AutoReload = true              # Useful during development/testing
LogLevel = "debug"             # Enable detailed plugin logging
CacheSize = "200MB"            # WASM compilation cache size
```

--------------------------------

### Download and Extract Navidrome

Source: https://www.navidrome.org/docs/installation/ubuntu-linux

Downloads the latest release, extracts the binary, and sets the necessary execution permissions.

```bash

wget https://github.com/navidrome/navidrome/releases/download/v0.XX.X/navidrome_0.XX.X_linux_amd64.tar.gz -O Navidrome.tar.gz
sudo tar -xvzf Navidrome.tar.gz -C /opt/navidrome/
sudo chmod +x /opt/navidrome/navidrome
sudo chown -R <user>:<group> /opt/navidrome

```

--------------------------------

### Configure Backup Settings in config.toml

Source: https://www.navidrome.org/docs/usage/admin/backup

Use this TOML configuration to set the backup directory, the number of backups to retain, and the schedule for automated backups.

```toml
[Backup]
Path = "/path/to/backup/folder"
Count = 7
Schedule =  "0 0 * * *"

```

--------------------------------

### Create Navidrome Directories

Source: https://www.navidrome.org/docs/installation/linux

Create the directory structure for Navidrome's executable and working directory, ensuring correct ownership and group permissions.

```bash
sudo install -d -o <user> -g <group> /opt/navidrome
sudo install -d -o <user> -g <group> /var/lib/navidrome
```

--------------------------------

### Download and Extract Navidrome

Source: https://www.navidrome.org/docs/installation/linux

Download the latest Navidrome release, extract its contents to the designated directory, and set execute permissions for the binary. Replace the URL with the actual release URL.

```bash
wget https://github.com/navidrome/navidrome/releases/download/v0.XX.X/navidrome_0.XX.X_linux_amd64.tar.gz -O Navidrome.tar.gz
sudo tar -xvzf Navidrome.tar.gz -C /opt/navidrome/
sudo chmod +x /opt/navidrome/navidrome
sudo chown -R <user>:<group> /opt/navidrome
```

--------------------------------

### Multi-Valued Composer Tagging in FLAC

Source: https://www.navidrome.org/docs/usage/library/tagging

Demonstrates how to use multi-valued tags for roles like 'COMPOSER' in FLAC files, allowing multiple individuals to be associated with a track.

```text
COMPOSER: Alice
COMPOSER: Bob

```

--------------------------------

### Multi-disc album directory layout

Source: https://www.navidrome.org/docs/usage/library/artwork

Example structure showing how disc-specific artwork files are matched within a multi-disc album folder.

```text

Music/
└── Artist - Album/
    ├── disc1/
    │   ├── disc1.jpg        ← matched by disc*.*
    │   ├── 01 - Track.flac
    │   └── 02 - Track.flac
    ├── disc2/
    │   ├── cd2.png          ← matched by cd*.*
    │   ├── 01 - Track.flac
    │   └── 02 - Track.flac
    └── cover.jpg            ← album-level fallback

```

--------------------------------

### Update and Upgrade Linux Distribution in WSL

Source: https://www.navidrome.org/docs/developers/dev-environment

Run this command after installing a Linux distribution in WSL to update its package lists and upgrade existing packages.

```bash
sudo apt update && sudo apt upgrade -y
```

--------------------------------

### Get Help for Navidrome Service Commands

Source: https://www.navidrome.org/docs/usage/admin/cli

Displays help information for the Navidrome service management commands. This is an alias for `navidrome svc --help`.

```bash
navidrome service --help
```

--------------------------------

### Manually Create a Backup with Docker Compose

Source: https://www.navidrome.org/docs/usage/admin/backup

Use this command with Docker Compose to manually create a backup. Replace `<service_name>` with your Navidrome service name.

```bash
sudo docker compose run <service_name> backup create
# service_name is usually `navidrome` 

```