From 100fb46b9a848b639d2c53320db8b3d2f4a62871 Mon Sep 17 00:00:00 2001 From: TJ Date: Mon, 28 Jul 2025 20:07:39 -0500 Subject: [PATCH] Update macos.md updated instructions to use 'navidrome svc install' etc. Added note about privacy and security disk access --- content/en/docs/installation/macos.md | 34 +++++---------------------- 1 file changed, 6 insertions(+), 28 deletions(-) diff --git a/content/en/docs/installation/macos.md b/content/en/docs/installation/macos.md index 6e18990c..dbccd38b 100644 --- a/content/en/docs/installation/macos.md +++ b/content/en/docs/installation/macos.md @@ -1,7 +1,7 @@ --- title: "macOS Install" linkTitle: "macOS" -date: 2017-01-04 +date: 2025-07-28 description: > Steps to install on macOS --- @@ -17,45 +17,23 @@ The example shown assumes a few things: 1. The binary has been downloaded and extracted to the `/opt/navidrome` folder. 2. A [configuration file](https://www.navidrome.org/docs/usage/configuration-options) for Navidrome has been created and is named `navidrome.toml` in that folder. Be sure to set the `DataFolder` option as well. 3. A log file for Navidrome has been created and is named `navidrome.log` in that folder. - -```xml - - - - - Label - navidrome - ProgramArguments - - /opt/navidrome/navidrome - -c - /opt/navidrome/navidrome.toml - - RunAtLoad - - StandardOutPath - /opt/navidrome/navidrome.log - StandardErrorPath - /opt/navidrome/navidrome.log - - -``` +4. Navidrome is added to the Full Disk Access list under System Preferences -> Privacy and Security. This is required for Navidrome to access your music library. Then to load the service, run: ```bash -launchctl load ~/Library/LaunchAgents/navidrome.plist +sudo /opt/navidrome/navidrome svc install ``` To start the service, run: ```bash -launchctl start navidrome +sudo /opt/navidrome/navidrome svc start ``` -You can verify that Navidrome has started by navigating to [http://localhost:4533](http://localhost:4533), by running `launchctl list | grep navidrome` or by checking the log file specified. +You can verify that Navidrome has started by navigating to [http://localhost:4533](http://localhost:4533) or by checking the log file specified. To stop the service, run: ```bash -launchctl stop navidrome +sudo /opt/navidrome/navidrome svc stop ``` {{% alert title="macOS Quarantine Error" color="warning" %}}