+0
Daily
299
stars
38
forks
4
watchers
31
prs
96
issues
0
releases
README
Soulseek Docker
Soulseek client running in Docker with web-based access via noVNC.
!Screenshot
Quick Start
yaml
services:
soulseek:
image: realies/soulseek
container_name: soulseek
restart: unless-stopped
ports:
- 6080:6080
volumes:
- ./appdata:/data/.SoulseekQt
- ./downloads:/data/Soulseek Downloads
- ./shared:/data/Soulseek Shared Folder
Access the UI at http://localhost:6080
Configuration
| Variable | Default | Description |
|----------|---------|-------------|
| PUID | 1000 | User ID |
| PGID | 1000 | Group ID |
| UMASK | 022 | File permission mask |
| TZ | - | Timezone (e.g., America/New_York) |
| VNCPWD | - | VNC password |
| VNCPWD_FILE | - | Path to VNC password file |
| VNC_PORT | 5900 | VNC server port |
| NOVNC_PORT | 6080 | noVNC web UI port |
| MODIFY_VOLUMES | true | Set ownership/permissions on volumes at startup |
Port Forwarding
For full connectivity, forward your Soulseek listening ports:
1. Start the container and open the UI
2. Go to Options → Login to find your ports
3. Forward those ports on your router to your Docker host
4. Add them to your compose file:
yaml
ports:
- 6080:6080
- 61122:61122 listening port
- 61123:61123 obfuscated port
Volumes
| Path | Description |
|------|-------------|
| /data/.SoulseekQt | Application data and settings |
| /data/Soulseek Downloads | Downloaded files |
| /data/Soulseek Shared Folder | Files to share |
| /data/Soulseek Chat Logs | Chat history (optional) |
Platform Support
| Architecture | Support |
|--------------|---------|
| linux/amd64 | Native |
| linux/arm64 | Via Box64 emulation |
ARM64 support enables running on Raspberry Pi, Apple Silicon, AWS Graviton, and other ARM devices.
Reverse Proxy
Example nginx configuration is available in soulseek.conf.