snapetech

slskdN is an unofficial, batteries-included fork of slskd, a web client for the Soulseek file-sharing network. This thread is for Unraid installation, configuration, and container-specific support. Project: https://github.com/snapetech/slskdN Docker image: https://ghcr.io/snapetech/slskdn Unraid template: https://github.com/snapetech/slskdN/raw/refs/heads/main/packaging/unraid/slskdn.xml License: AGPL-3.0 COMMUNITY APPLICATIONS STATUS The slskdN Unraid template is being submitted to Community Applications. Until approval, the template can be installed manually from the repository. TEMPLATE USABILITY FEEDBACK Community feedback requested that Docker environment variables be exposed in the template and left blank when optional, so users do not have to hunt through documentation for settings that were omitted from the template. The current template exposes the documented optional SLSKD_* environment overrides as advanced fields with blank values. Core ports, paths, credentials, and image-managed runtime settings retain safe defaults. CONTAINER DETAILS Web UI: 5030/tcp HTTPS Web UI: 5031/tcp Soulseek incoming connections: 50300/tcp slskdN mesh overlay: 50305/tcp Public DHT and shared UDP/QUIC mesh traffic: 50305/udp Optional QUIC data overlay: 50401/udp Port 50300/tcp should be forwarded from the router to the Unraid server for the best Soulseek connectivity. Ports 50305/tcp and 50305/udp are used when DHT/mesh services are enabled. Port 50401/udp is only needed when the optional overlay_data QUIC data plane is enabled. Port 55305 is a loopback-only QUIC backend port and should not be published. DEFAULT PATHS /app - application data, configuration, and databases /downloads - downloaded files; choose an Unraid share /music - optional music library; read-only access is recommended The template intentionally leaves Downloads and Music Library blank so users can select their own shares instead of having guessed shares created automatically. ENVIRONMENT SETTINGS PUID: 1000 PGID: 1000 TZ: America/Chicago Web UI username: slskd Web UI password: slskd Soulseek username: set in the web UI or the template field Soulseek password: set in the web UI or the template field The template includes advanced fields for the documented optional SLSKD_* Docker environment overrides covering downloads, shares, search, Soulseek behavior, obfuscation, proxies, authentication, metrics, notifications, logging, and integrations. Optional fields are blank by default. Runtime-only SLSKD_SCRIPT_DATA and image metadata variables such as SLSKD_DOCKER_TAG are not user configuration fields. Complete environment-variable reference: https://github.com/snapetech/slskdN/blob/main/docs/config.md Change the default web UI username and password after the first login. Do not combine PUID/PGID with a Docker --user override. FIRST RUN 1. Install the template from Community Applications when the listing is approved. Until then, use the template XML linked above as a local user template. 2. Choose an Unraid share and directory for Downloads. 3. Optionally choose a read-only Unraid share and directory for Music Library. 4. Open the web UI at http://YOUR_UNRAID_IP:5030. 5. Change the default web UI credentials. 6. Configure the Soulseek account and shared folders. 7. Forward 50300/tcp, and forward 50305/tcp and 50305/udp if DHT/mesh services are enabled. FEATURES Automatic replacement of stuck downloads with alternative sources Wishlist and background search with automatic downloads Source ranking based on speed, queue, and history User notes and download history Blocked users in search results Multiple download destinations File deletion from the web UI Push notifications through Ntfy, Pushover, and Pushbullet Tabbed browse sessions DHT and mesh networking when explicitly enabled Additional slskdN enhancements REPORTING PROBLEMS Please include: Unraid version Container image tag Container logs Template settings Host-to-container path mappings Exact steps to reproduce the issue Redact passwords, API keys, Soulseek credentials, public IP addresses, and other private information from logs. Application source and general bug reports: https://github.com/snapetech/slskdN