slskd

Q: Why does slskd 0.25.1 show "Property 'retry' not found" and ignore the retry configuration?

The `retry` option is not available in slskd 0.25.1; it had not been released yet and only appeared in the `master` documentation. Remove the `retry:` block from `slskd.yml` when running 0.25.1 stable. To use unreleased retry settings, switch to the canary Docker image and expect possible configuration changes; otherwise wait for a stable release containing the feature, such as 0.26.x. Verify the running version under **System → Info** and consult the documentation matching your release tag rather than `master`.

SHA-256

3.2k stars·File Management·SHA-256 checksum verified

Modern web-based client-server application for Soulseek file-sharing network, featuring secure access, search, and download management.

Smart Download

Download Download Version

v0.25.1 · 52.9 MB

A web-based Soulseek client you can run anywhere, with Docker and secure remote access.

Core Features

Web-based UI accessible from any browser, no local client needed
Token-based authentication and reverse proxy support for secure internet exposure
Docker deployment with PUID/PGID, integrates with *arr media stacks
Download management grouped by user/folder, queue position display, batch operations
Advanced search with multiple keywords, sorting, and filtering

What It Can't Do

•Default username/password is slskd/slskd; change immediately if exposed to the internet. 2. Enabling SLSKD_REMOTE_CONFIGURATION allows modifying config from UI, but be cautious on public deployments. 3. Port 50300 must be open in firewall for incoming connections. 4. HTTPS uses a self-signed certificate; use a reverse proxy with Let's Encrypt for production.

Use Cases

Self-hosted file download server for remote Soulseek access
Automated media downloads paired with Jellyfin/Plex or similar

Detailed Introduction

slskd is a client-server application that brings the Soulseek peer-to-peer file-sharing network to the web. It runs as a daemon or Docker container, accessible from any browser with token-based authentication. Features include searching, filtering results, managing downloads with queue info, browsing user shares, and chatting. Designed for self-hosting, it supports reverse proxies and is ideal for home servers or cloud deployments. Compared to the official Soulseek client, slskd offers a clean web UI, easy remote access, and seamless integration with Docker-based media stacks like the *arr suite.

Troubleshooting & FAQ (2)

Troubleshooting

Why does slskd 0.25.1 show "Property 'retry' not found" and ignore the retry configuration?

The retry option is not available in slskd 0.25.1; it had not been released yet and only appeared in the master documentation. Remove the retry: block from slskd.yml when running 0.25.1 stable. To use unreleased retry settings, switch to the canary Docker image and expect possible configuration changes; otherwise wait for a stable release containing the feature, such as 0.26.x. Verify the running version under **System → Info** and consult the documentation matching your release tag rather than master.

GitHub Issue #1748

Troubleshooting

How to fix "aliases may not contain path separators '/' or '\\'" when using a shared directory alias in slskd?

This is a parsing bug in slskd 0.24.5.0: the alias parser uses the last ] instead of the first, so bracket characters later in the path (for example, [id]) are incorrectly treated as part of the alias. Upgrade to the canary build or the next release containing the fix. As a temporary workaround, remove square brackets from the shared path or omit the alias prefix.

GitHub Issue #1667

Getting Started

Download installer

Click the button above to download the installer for your system

Linux· 52.9 MB Windows· 54.7 MB macOS· 52.2 MB

Install the software

Install the appropriate package for your distro (dpkg / rpm / AppImage)

Run with Docker: docker run -d -p 5030:5030 -p 5031:5031 -p 50300:50300 -e SLSKD_REMOTE_CONFIGURATION=true -v /your/data:/app --name slskd slskd/slskd:latest

Open http://localhost:5030 and log in with default credentials slskd/slskd

Configure Soulseek credentials and download path in the web UI, then start searching

Install Guide

Run with Docker: docker run -d -p 5030:5030 -p 5031:5031 -p 50300:50300 -e SLSKD_REMOTE_CONFIGURATION=true -v /your/data:/app --name slskd slskd/slskd:latest
Open http://localhost:5030 and log in with default credentials slskd/slskd
Configure Soulseek credentials and download path in the web UI, then start searching

File Integrity

SHA-256 checksum verified

Checksum extracted from GitHub official Release page

SHA256 Checksum

5435531bd256a13c026180e30f3123a5d9f61e5653eca149cd93f1acfdbc2b99

This checksum is extracted from the GitHub Release page. Verify file integrity after download.

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source

Environment Guide

Uninstall Info

Docker: docker rm -f slskd and remove the volume. Binary: delete the extracted folder and the config directory (~/.local/share/slskd on Linux or %localappdata%/slskd on Windows).

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info

LicenseMIT

Last Updated2026-10-15 06:43:53

GitHub Repository

Having issues? Check the FAQ below

2 FAQs

Similar Projects

localsend

Free, open-source, cross-platform tool for secure local network file sharing — no internet needed.

croc

A CLI tool for simple, secure, and cross-platform file transfers between any two computers, with end-to-end encryption and resume support.

cloudreve

Self-hosted file management system with multi-cloud support, offline downloads, and WebDAV. Lightweight and easy to deploy.