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
The example shown assumes a few things:
- The binary has been downloaded and extracted to the
- A configuration file for Navidrome has been created and is named
navidrome.tomlin that folder. Be sure to set the
DataFolderoption as well.
- A log file for Navidrome has been created and is named
navidrome.login 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
Was this page helpful?
Glad to hear it! Please tell us how we can make it even better.
Sorry to hear that. Please tell us how we can improve.