Baike.dev
Log in
Back to tool/Back to issues
#6043·navidrome

[Bug]: ScanOnStartup not being respected / Cannot cancel scan

Author: rumzieCreated Aug 28, 2026Updated Sep 11, 2026
Labelsbugtriage

I confirm that:

  • I have searched the existing open AND closed issues to see if an issue already exists for the bug I've encountered
  • I'm using the latest version (your issue may have been fixed already)

Version

v0.63.2

Current Behavior

Running Windows 11 with NSSM I am trying to cancel/kill a library scan, but when restarting the navidrome service, the scanner will automatically start again, even with Scanner.ScanOnStartup = false. Possibly a feature request to allow cancelling a library scan? I have a large library and sometimes files are added/modified/deleted in bulk during a scan.

Expected Behavior

Upon killing/restarting the navidrome service while a scan is in progress, the scan should not automatically resume once the service is started again (especially with Scanner.ScanOnStartup = false)

Steps To Reproduce

  1. Disable ScanOnStartup in TOML file
  2. Start a library scan
  3. Kill the navidrome process/service
  4. Start the navidrome process/service
  5. Observe the scanner automatically restart

Environment

markdown
- OS: Windows 11
- Browser: Chrome
- Client: Navidrome

How Navidrome is installed?

Binary (from downloads page)

Configuration

toml
# This is just an example! Please see available options to customize Navidrome for your needs at
# IMPORTANT: Use single quotes for paths in Windows
# https://www.navidrome.org/docs/usage/configuration/options/#available-options

LogLevel = 'DEBUG'
LogFile = 'Logging\Log'

BaseUrl = 'REDACTED'

Scanner.Schedule = '0'
Scanner.Enabled  = false
Scanner.ArtistJoiner = '; '
Scanner.PurgeMissing = 'always'
Scanner.ScanOnStartup = false
# Scanner.Schedule = '@every 24h'

#TranscodingCacheSize = '150MiB'

# MusicFolder = 'REDACTED'
MusicFolder = 'REDACTED'
DataFolder = 'data'

# Set this to the path of your ffmpeg executable
# FFmpegPath = 'C:\Program Files\ffmpeg\bin\ffmpeg.exe'

LastFM.Enabled = true
LastFM.ApiKey = 'REDACTED'
LastFM.Secret = 'REDACTED'

EnableDownloads = false
EnableSharing = false
EnableStarRating = false
EnableUserEditing = false
EnableInsightsCollector = false
EnableCoverAnimation = false
EnableTranscodingConfig = false
EnableScrobbleHistory = true
Inspect.Enabled = false
RecentlyAddedByModTime = true
Jukebox.AdminOnly = true
CoverArtQuality = 100
CoverArtPriority = 'embedded'
DiscArtPriority = 'embedded'
# Plugins.Enabled = false

Relevant log output

bash

Anything else?

No response

Code of Conduct

  • I agree to follow Navidrome's Code of Conduct

Source: navidrome/navidrome

View original on GitHubView discussion on GitHub