soundsible
ES

GET STARTED

Choose your setup.

Run Soundsible on your computer or a server. Then connect the devices you listen on.

Latest stable release v0.14.0 ↗·Guides match this release.

Native installation

Linux · macOS · Windows

PRIMARY METHOD

Run directly on your machine with the launcher and full access to configuration. Requires Python 3.10+, Git, FFmpeg and Node.js 22+.

Installation guide →Server deployment
Quick commands by operating system

                      sudo apt install -y git ffmpeg python3 python3-venv python3-pip nodejs npm

git clone --branch v0.14.0 --single-branch https://github.com/Arzuparreta/soundsible.git
cd soundsible

cd ui_web && npm ci && cd ..

python3 run.py

Commands select the documented release. Linux commands use Debian/Ubuntu packages; verify Node.js is 22 or newer. macOS requires Homebrew. On Windows, reopen PowerShell after installing prerequisites.

First launch: complete setup at localhost:5099/setup, then launch the engine. Keep the terminal open while listening.

Desktop app

Linux · Windows

BETA

A packaged app for a single computer, with no terminal required. The web player is included. Check the release assets for the installer that matches your system.

Download from GitHub ↗Read the beta guide

Docker

Linux amd64 · arm64

Run a containerized server on a NAS, Raspberry Pi or Linux host. The image includes the player and audio dependencies. Read the deployment guide for persistent storage, backups and upgrades.

Docker deployment guide →
Install the published release

Requires Docker with Compose. Creates a new soundsible folder and stores the release tag in .env. If that folder already exists, the commands stop without replacing it. 

mkdir soundsible && cd soundsible &&
curl --fail --location https://raw.githubusercontent.com/Arzuparreta/soundsible/a80b0bdd25b71fca5b91eadd9fee6f2f8b86e9e3/compose.yaml -o compose.yaml &&
printf 'SOUNDSIBLE_TAG=0.14.0\n' > .env &&
docker compose up -d

Wait for the container to report healthy, then open http://localhost:5005/player/. Keep .env for later restarts and deliberate upgrades.

Phones and other clients

Web · iOS · OpenSubsonic

Already have a Soundsible server? Open its player in your browser, install the native iOS app or connect a compatible OpenSubsonic client. These connect to your server; they do not replace it.

iPhone / iPad →Other clients →

iOS installation is through sideloading, not the App Store. See the guide for requirements and availability.

Need help connecting from another device or outside your home? Read the server and remote access guide.

Search documentation