Web
Already on your server
Open /web and add it to your home screen. Try it first on the demo, with 29 public-domain classics on the shelf.
Open the demoDownload · server
The server is the only thing you install. It serves the web player and the API the apps connect to. Docker is the easy path for a NAS, a home server or a VPS.
Already have a server? Get the app for iPhone, iPad and Android
ghcr.io/kodestar/audiosilo-server for amd64 and arm64, with the web player and ffmpeg inside. Only /data is persisted; mount your books read-only.
Create the data folder first, and set PUID and PGID to its owner. On a NAS that is usually your NAS user: see the Synology guide.
Updating is a new image: docker compose pull && docker compose up -d. Back up the data folder first.
services:
audiosilo:
image: ghcr.io/kodestar/audiosilo-server:latest
restart: unless-stopped
ports:
- "8080:8080"
volumes:
- ./data:/data # database, config, certificates
- /srv/audiobooks:/library:ro # your books, mounted read-only
environment:
PUID: "1000" # owner of ./data (Unraid: 99, Synology: usually 1026)
PGID: "1000" # group of ./data (Unraid: 100, Synology: usually 100)
# AUDIOSILO_PUBLIC_URL: "https://books.example.com" # used in QR/invite links
# AUDIOSILO_TLS_MODE: "off" # only behind a TLS-terminating reverse proxy
AUDIOSILO_WEB_DIR: /app/webmkdir -p data # create the data folder first
docker compose up -d
docker compose logs # the admin password and auth code, shown onceOne download per system on GitHub Releases. The web player is built in, and ffmpeg is fetched on first use if you don't have it. Run with --setup to choose the admin password in the browser.
Server releasesPure Go with no C toolchain needed (SQLite is pure Go too), so it builds wherever Go 1.26 does. AGPLv3.
git clone https://github.com/KodeStar/audiosilo-server
cd audiosilo-server
go build -o bin/audiosilo ./cmd/audiosilo
# First run prints the admin password and auth code once. Save them.
AUDIOSILO_TLS_MODE=off ./bin/audiosilo --data ./data Web
Open /web and add it to your home screen. Try it first on the demo, with 29 public-domain classics on the shelf.
Open the demoiPhone and iPad
Free on the App Store for iPhone and iPad. Pair it with an invite link or QR code.
Android
Free on Google Play for Android phones and tablets. Pair it with an invite link or QR code.
No Google Play? Download the APK from GitHub, or let Obtainium install it and keep it up to date.
Pick one source: the two can't update each other. Switching means uninstalling, which removes the app's downloads and sign-ins. Your progress stays on your server. How to install it
On a watch: the Apple Watch app comes with the iPhone app. Set it up from your iPhone, send it a book and leave the phone at home. It needs iPhone app 2.6 or later and watchOS 11 or later, and server 2.6 or later with ffmpeg. Coming in the 2.7 app update: the same on a Wear OS watch (Wear OS 3 or later), set up from your Android phone.
New to this? The installation guide walks through a Docker setup end to end.