# NaviClean

NaviClean is a Docker-first cleaner and organizer for mounted Navidrome music libraries, providing guided path previews, duplicate review, unindexed and non-music cleanup, Spotify-backed discovery, and audio conversion. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3092/naviclean

## Description

NaviClean is a Docker-first cleaner and organizer for mounted Navidrome music libraries, providing guided path previews, duplicate review, unindexed and non-music cleanup, Spotify-backed discovery, and audio conversion for users maintaining self-hosted music collections.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

55/100 (Fair), based on 3 of 4 factors.
- Maintained: 100 (last commit 11 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/naviclean-07yz3ba16xdlkq?q=NaviClean

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/3092/naviclean), the self-hosted and open-source app directory.
