Skip to content

Download · server v2.4.1

Install one thing.

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.

Docker Recommended

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.

Updating is a new image: docker compose pull && docker compose up -d. Back up the data folder first.

docker-compose.yml
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)
      PGID: "1000"                    # group of /data (Unraid: 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/web
Terminal
docker compose up -d
docker compose logs     # the admin password and auth code, shown once

Unraid

In Community Applications: search the Apps tab for AudioSilo.

Unraid install guide
  • It's the LinuxServer.io image, lscr.io/linuxserver/audiosilo, for amd64 and arm64, with the web player and ffmpeg inside.
  • Point /config at an appdata folder on your cache or pool and /audiobooks at your books (mounted read-only), then add /audiobooks as a library in the admin console. The admin password and auth code are printed once in the container log on first start, so save them.
  • Rebuilt automatically for every server release; update it from Unraid's Docker tab.

Native binaries

One 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 releases
  • Linux amd64 and arm64: .tar.gz, .deb and .rpm (with a systemd unit)
  • macOS Apple silicon and Intel: .tar.gz
  • Windows amd64 and arm64: .zip
  • Every release also carries checksums.txt.

From source

Pure Go with no C toolchain needed (SQLite is pure Go too), so it builds wherever Go 1.26 does. AGPLv3.

Terminal
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

Then press play.

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 demo

New to this? The installation guide walks through a Docker setup end to end.

Try the demo No sign-up. Opens in your browser.