macOS Install
Navidrome can be ran by simply double-clicking the binary that has been downloaded from the release page or by running it in the command line. However, that will keep a terminal window open while Navidrome is running.
To have Navidrome running in the background, we can run it as a service.
We define a service as shown below and save that in a file named navidrome.plist
in the ~/Library/LaunchAgents/
folder.
The example shown assumes a few things:
- The binary has been downloaded and extracted to the
/opt/navidrome
folder. - A configuration file for Navidrome has been created and is named
navidrome.toml
in that folder. Be sure to set theDataFolder
option as well. - A log file for Navidrome has been created and is named
navidrome.log
in that folder.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>navidrome</string>
<key>ProgramArguments</key>
<array>
<string>/opt/navidrome/navidrome</string>
<string>-c</string>
<string>/opt/navidrome/navidrome.toml</string>
</array>
<key>RunAtLoad</key>
<true/>
<key>StandardOutPath</key>
<string>/opt/navidrome/navidrome.log</string>
<key>StandardErrorPath</key>
<string>/opt/navidrome/navidrome.log</string>
</dict>
</plist>
Then to load the service, run:
launchctl load ~/Library/LaunchAgents/navidrome.plist
To start the service, run:
launchctl start navidrome
You can verify that Navidrome has started by navigating to http://localhost:4533, by running launchctl list | grep navidrome
or by checking the log file specified.
To stop the service, run:
launchctl stop navidrome
macOS Quarantine Error
If you download the binary directly from GitHub, you may see an error message saying:
"navidrome" is damaged and can't be opened. You should move it to the Bin.
This error occurs because macOS’s Gatekeeper has quarantined the navidrome
executable as it was downloaded from the internet. To fix this issue, open Terminal and run:
sudo xattr -d com.apple.quarantine /path/to/navidrome
Replace /path/to/navidrome
with the actual path to your binary (e.g., /opt/navidrome/navidrome
). This will remove the quarantine flag from the navidrome binary and allow it to run.
Feedback
Was this page helpful?