slskd

Soulseek client in your browser for finding and sharing music

  • ghcr.io/hsinghhira/slskd:1.0.1
  • v0.26.2
  • Updated 21 Nov 2026
  • port 6779
  • port 6780
  • amd64 · arm64
  • Media
  • 4.3k stars

Screenshots

slskd screenshot 1: Searchslskd screenshot 2: Downloadsslskd screenshot 3: Search results

Open the app

Web UI

http://localhost:6779/

API docs

http://localhost:6779/swagger

About slskd

slskd connects your server to Soulseek, a peer-to-peer network for sharing music. Search for albums and tracks, download them straight to your server and share your own music back, all from a web page. It runs all the time, so downloads keep going while your computer is off.

Features

  • Search the Soulseek network and download whole folders
  • Shares your music library with others, read-only
  • Chat rooms and private messages
  • Upload and download limits and speed caps
  • An API, so apps like Lidarr helpers can use it

How to use

  1. Set your Soulseek user name and password before you install (any free name works).
  2. Open slskd from your dashboard.
  3. Sign in with the login from the app's logs (the box marked CREDENTIALS).
  4. Type in Search and pick what to download.
  5. Find your files in /DATA/Downloads/slskd.

Before you install

Set SLSKD_SLSK_USERNAME and SLSKD_SLSK_PASSWORD to your Soulseek account; any free name works, since the account is made the first time it signs in. Without them slskd starts but can't join the network. The web UI login is slskd with a password made on first start, shown in the app's logs in the box marked CREDENTIALS and saved in /DATA/AppData/slskd/app/.web_password. Downloads go to /DATA/Downloads/slskd, and /DATA/Media/Music is shared read-only. Forward port 6780 on your router for faster transfers. Speed limits and the other settings are in the Variables tab and are added in the app settings, or in the web UI under Options.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone. It is filled in from your ZimaOS time zone.
PUID$PUIDThe user that owns the files slskd downloads. It is filled in by ZimaOS. Leave it.
PGID$PGIDThe group that owns the files slskd downloads. It is filled in by ZimaOS. Leave it.
SLSKD_SLSK_USERNAME—Your Soulseek user name. Pick any free name: the account is made the first time it signs in.
SLSKD_SLSK_PASSWORD—Your Soulseek password.
SLSKD_PASSWORD—The web UI password (user name slskd). Leave it empty and one is made for you: it is shown in the app's logs, in the box marked CREDENTIALS.
SLSKD_SLSK_LISTEN_PORT6780The port other Soulseek users connect to. Keep it 6780, the same as the published port. Forward it on your router for the best results.

Web UI

VariableDefault valueDescription
SLSKD_USERNAMEslskdThe web UI user name.
SLSKD_JWT_KEY—The key sign-ins are signed with. It is made on first start and kept in /app/secrets.env.
SLSKD_API_KEY—An API key for other apps, at least 16 characters.
SLSKD_NO_AUTHfalseSet to true to turn off the web UI login. Only do this behind another sign-in.
SLSKD_URL_BASE/The path slskd is served under behind a reverse proxy, like /slskd.
SLSKD_REMOTE_CONFIGURATIONtrueLets you change the options file from the web UI (Options). Set to false to lock it.

Transfers

VariableDefault valueDescription
SLSKD_SHARED_DIR/musicThe folders you share, separated by semicolons. /music is your /DATA/Media/Music folder.
SLSKD_UPLOAD_SLOTS10How many uploads may run at once.
SLSKD_UPLOAD_SPEED_LIMIT—The upload speed cap in KiB/s. Leave it out for no cap.
SLSKD_DOWNLOAD_SLOTS—How many downloads may run at once.
SLSKD_DOWNLOAD_SPEED_LIMIT—The download speed cap in KiB/s. Leave it out for no cap.
SLSKD_SHARE_FILTER—Files not to share, as patterns separated by semicolons, like \.ini$;Thumbs.db$.

Soulseek

VariableDefault valueDescription
SLSKD_SLSK_DESCRIPTION—The text on your Soulseek profile.
SLSKD_ROOMS—Chat rooms to join on start, separated by semicolons.

Server

VariableDefault valueDescription
SLSKD_NO_VERSION_CHECKfalseSet to true to stop checking for new versions.
SLSKD_DEBUGfalseSet to true for more detail in the log.
docker-compose.yml
name: slskd

services:
  slskd:
    image: ghcr.io/hsinghhira/slskd:1.0.1
    container_name: slskd
    restart: unless-stopped
    stop_grace_period: 30s
    network_mode: bridge
    environment:
      - TZ=$TZ
      - PUID=$PUID
      - PGID=$PGID
      - SLSKD_SLSK_USERNAME=
      - SLSKD_SLSK_PASSWORD=
      - SLSKD_PASSWORD=
      - SLSKD_SLSK_LISTEN_PORT=6780
    ports:
      - target: 5030
        published: "6779"
        protocol: tcp
      - target: 6780
        published: "6780"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/app
        target: /app
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/Downloads/slskd
        target: /downloads
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/Media/Music
        target: /music
        read_only: true
        bind:
          create_host_path: true
    deploy:
      resources:
        limits:
          cpus: "2.00"
          memory: 1024M
        reservations:
          cpus: "0.05"
          memory: 128M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/slskd/icon.png
    x-casaos:
      id: com.icestore.slskd
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone.
        - container: PUID
          description:
            en_US: >-
              The user that owns the files slskd downloads. It is filled in
              by ZimaOS. Leave it.
        - container: PGID
          description:
            en_US: >-
              The group that owns the files slskd downloads. It is filled in
              by ZimaOS. Leave it.
        - container: SLSKD_SLSK_USERNAME
          description:
            en_US: >-
              Your Soulseek user name. Pick any free name: the account is
              made the first time it signs in.
        - container: SLSKD_SLSK_PASSWORD
          description:
            en_US: >-
              Your Soulseek password.
        - container: SLSKD_PASSWORD
          description:
            en_US: >-
              The web UI password (user name slskd). Leave it empty and one
              is made for you: it is shown in the app's logs, in the box
              marked CREDENTIALS.
        - container: SLSKD_SLSK_LISTEN_PORT
          description:
            en_US: >-
              The port other Soulseek users connect to. Keep it 6780, the
              same as the published port. Forward it on your router for the
              best results.
      ports:
        - container: "5030"
          description:
            en_US: slskd web UI and API, published on host as 6779
        - container: "6780"
          description:
            en_US: Soulseek peer connections, published on host as 6780
      volumes:
        - container: /app
          description:
            en_US: >-
              slskd's options file (slskd.yml), its database, logs and this
              install's own keys (secrets.env, .web_password). Back it up.
        - container: /downloads
          description:
            en_US: >-
              Finished and unfinished downloads, in /DATA/Downloads/slskd.
        - container: /music
          description:
            en_US: >-
              The music you share, from /DATA/Media/Music (read-only).

x-casaos:
  id: com.icestore.slskd
  architectures:
    - amd64
    - arm64
  main: slskd
  author: HSinghHira
  category: Media
  developer: slskd
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/slskd/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/slskd/screenshot-3.png
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/slskd/screenshot-1.png
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/slskd/screenshot-2.png
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/slskd/screenshot-3.png
  title:
    en_US: slskd
  tagline:
    en_US: Soulseek client in your browser for finding and sharing music
  description:
    en_US: >-
      slskd connects your server to Soulseek, a peer-to-peer network for
      sharing music. Search for albums and tracks, download them straight to
      your server and share your own music back, all from a web page. It
      runs all the time, so downloads keep going while your computer is off.


      **Features**


      - Search the Soulseek network and download whole folders

      - Shares your music library with others, read-only

      - Chat rooms and private messages

      - Upload and download limits and speed caps

      - An API, so apps like Lidarr helpers can use it


      **How to use?**


      1. Set your Soulseek user name and password before you install (any
         free name works).

      2. Open slskd from the ZimaOS dashboard.

      3. Sign in with the login from the app's logs (the box marked
         CREDENTIALS).

      4. Type in Search and pick what to download.

      5. Find your files in /DATA/Downloads/slskd.
  tips:
    before_install:
      en_US: >-
        1. Set SLSKD_SLSK_USERNAME and SLSKD_SLSK_PASSWORD to your Soulseek
           account. Any free name works: it is made the first time.


        2. Put the music you want to share in /DATA/Media/Music.


        3. Start the installation. It is ready in under a minute.


        4. Open the app's logs. Find the box marked CREDENTIALS. It has the
           web UI login.


        5. Open http://[ZIMAOS-IP-ADDRESS]:6779 and sign in.


        6. For faster downloads, forward port 6780 on your router to your
           ZimaOS IP.
  index: /
  port_map: "6779"
  scheme: http
  is_uncontrolled: false
  version: "0.26.2"
  update_at: "2026-11-21"
  release_notes:
    en_US: |-
      - First IceStore release, on port 6779 (web UI) and 6780 (Soulseek)
      - Built on slskd/slskd 0.26.2
      - Each install makes its own web UI password and JWT key on first start, instead of the default slskd / slskd; the login is in the CREDENTIALS box in the logs
      - Fixed: slskd stopped at start because /downloads/incomplete did not exist; the download folders are now made for you.
      - The store now names the exact image version (1.0.1), so a new install downloads the fixed image instead of reusing an older one ZimaOS kept.
  repo: "https://github.com/slskd/slskd"
  support: "https://github.com/slskd/slskd/issues"
  docs: "https://github.com/slskd/slskd/blob/master/docs/config.md"

Install slskd

Something not working with slskd?

Report it so it gets fixed, or ask for an app that is not here yet.

More Media apps

See all