• Docker installed on your machine or server
• Port 6080 open and accessible for noVNC web access (or reverse proxied, nginx example at soulseek.conf)
• Ports required by Soulseek open and forwarded from your router to the Docker host machine

1. Map port 6080 on the host machine to port 6080 on the Docker container.

• If using a GUI or webapp (e.g., Synology) to manage Docker containers, set this configuration option when launching the container from the image.
• With Docker CLI, use the -p 6080:6080 option.

2. Map the ports Soulseek uses on the Docker container.

• The first time it runs, Soulseek starts up using a random port. It can also be manually configured in Options -> Login.
• Wait for a Soulseek settings file to appear in /data/.SoulseekQt/1, this is saved every 60 minutes by default but can be forced to be more freuquent from Options -> General.
• Map both ports from your router to the machine hosting the Docker image, and from the outside of the Docker image to the server within it. See the Soulseek FAQ for more details.

3. Launch the Docker container and map the required volumes (see How to Launch section below).

4. Access the Soulseek UI by opening a web browser and navigating to http://docker-host-ip:6080 or https://reverse-proxy, depending on your configuration.

The container supports the following configuration options:

version: "3"
services:
  soulseek:
    image: realies/soulseek
    container_name: soulseek
    restart: unless-stopped
    volumes:
      - /persistent/appdata:/data/.SoulseekQt
      - /persistent/downloads:/data/Soulseek Downloads
      - /persistent/logs:/data/Soulseek Chat Logs
      - /persistent/shared:/data/Soulseek Shared Folder
    environment:
      - PGID=1000
      - PUID=1000
    ports:
      - 6080:6080
      - 61122:61122 # example listening port, check Options -> Login
      - 61123:61123 # example obfuscated port, check Options -> Login

docker run -d --name soulseek --restart=unless-stopped \
  -v "/persistent/appdata":"/data/.SoulseekQt" \
  -v "/persistent/downloads":"/data/Soulseek Downloads" \
  -v "/persistent/logs":"/data/Soulseek Chat Logs" \
  -v "/persistent/shared":"/data/Soulseek Shared Folder" \
  -e PGID=1000 \
  -e PUID=1000 \
  -p 6080:6080 \
  -p 61122:61122 \ # example listening port, check Options -> Login
  -p 61123:61123 \ # example obfuscated port, check Options -> Login
  realies/soulseek

Port Configuration

• Port 6080 is used by noVNC for accessing Soulseek from your local network. Only TCP type is needed.
• Ports 61122 and 61123 are examples; open Soulseek to determine the exact ports to forward. Only TCP type is needed.
• Configure these ports to forward from your router to the machine hosting the Docker image. See the Soulseek Port Forwarding Guide for more details.

Volume Configuration

• Mount the required directories for Soulseek data persistence.
• The example mounts an extra directory /music/FLAC for sharing; mount the directory you want to share.