NaviClean
NaviClean is a Docker-first cleaner and organizer for mounted Navidrome music libraries, providing guided path previews, duplicate review, unindexed and…
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
55/100 Fair
- Maintained
- 100last commit 11 days ago
- Popular
- 00 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today, links checked 20 days ago
- GitHub stars
- 0
- Open issues
- 0
- Last commit
- 2026-11-10
- Latest release
- v0.7.3
- Activity
- declining
Checked 6 days ago - source: GitHub (thedinz/NaviClean)
Resources & Compatibility
Requirements not published yet.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Docker setup and default access Run image ghcr.io/thedinz/naviclean:latest with /data mapped for config and /music for your Navidrome library, using PUID=1000 and PGID=1000. The web UI is served on port 8080 with the default login admin/admin. source
- Reverse proxy When fronting NaviClean with a reverse proxy, set NAVICLEAN_TRUST_PROXY=1, NAVICLEAN_SECURE_COOKIES=auto, and NAVICLEAN_COOKIE_SAMESITE=lax. source
Fetched 47 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
What are the default web UI port and login?
The web UI is served on port 8080. The default login is admin/admin.
What reverse proxy environment variables should I set?
Set NAVICLEAN_TRUST_PROXY=1, NAVICLEAN_SECURE_COOKIES=auto, and NAVICLEAN_COOKIE_SAMESITE=lax. These are the reverse-proxy settings listed in the defaults.
What user IDs should I use on Unraid?
Use PUID=99 and PGID=100. This lets NaviClean write to /mnt/user/appdata/naviclean and the mounted music share.
Can I clean duplicates immediately?
No, duplicate cleanup unlocks only after organization is complete. NaviClean previews clean artist, album, and track paths before that step is available.
How do I enable the internal diagnostics page?
Set NAVICLEAN_ADVANCED_DIAGNOSTICS=1 in the container environment. This shows the Diagnostics page and enables the matching-inspection API routes.
Answers sourced from github.com
Community
Collected 49 days ago - public community threads