Skip to content

Installation

AudioSilo Server is the only thing you install. Every option below includes the web player, so the apps work out of the box. Docker is the recommended path for always-on, NAS, VPS and multi-user setups.

Requirements

  • Docker (to run the published image), or a single downloaded binary.
  • A folder of audiobooks (m4b, or mp3 parts - the scanner figures out the shape).
  • ffmpeg/ffprobe is optional but recommended (durations and chapters), so the Docker image includes it; the native binaries fetch it automatically on first run if it isn't present.

Option 1: Docker (recommended)

Make a folder for AudioSilo with a docker-compose.yml in it, mounting your audiobooks read-only and persisting /data:

docker-compose.yml
services:
  audiosilo:
    image: ghcr.io/kodestar/audiosilo-server:latest
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./data:/data            # db, config, certs (first run prints admin creds once)
      - /srv/audiobooks:/library:ro
    environment:
      PUID: "1000"              # owner of ./data (Unraid: 99, Synology: usually 1026)
      PGID: "1000"              # group of ./data (Unraid: 100, Synology: usually 100)
      AUDIOSILO_WEB_DIR: /app/web
      # AUDIOSILO_PUBLIC_URL: "https://books.example.com"  # used in QR/invite links

Create the data folder before the first start, then start it and read the logs to grab your one-time admin credentials:

Terminal
mkdir -p data              # create the data folder first
docker compose up -d
docker compose logs        # first run prints the admin password + auth code ONCE

Set PUID/PGID to the user and group that own the data folder. The server runs as that user, and it must be able to read and write the folder.

  • Linux: your id -u/id -g.
  • Unraid: 99/100.
  • A NAS such as Synology: the folder's owner, usually your NAS user. On Synology that is usually 1026/100. Give that user read and write on the folder in the NAS's file manager. See the Synology install guide.

Backups go in data/backups. A backup folder mounted elsewhere (AUDIOSILO_BACKUP_DIR) needs the same owner. If the container keeps restarting or says permission denied, see permission problems in the troubleshooting guide. The Docker install guide has the full walkthrough.

Updating the server or the bundled player is always a new image:

Terminal
docker compose pull && docker compose up -d

Option 2: Unraid

On Unraid, install from Community Applications: search the Apps tab for AudioSilo. The app is the LinuxServer.io image, lscr.io/linuxserver/audiosilo, with the web player and ffmpeg inside, rebuilt for every server release.

Point Appdata (/config) at a cache or pool path such as /mnt/cache/appdata/audiosilo, and Audiobooks (/audiobooks) at your books share. Leave PUID/PGID at 99/100. On first start the admin password and auth code are printed once in the container log (in the Docker tab, click the AudioSilo icon, then Logs). In the admin console, add /audiobooks as your library: the path inside the container, not your /mnt/user share. The Unraid install guide covers the template fields, reverse proxies and moving from the image above.

Option 3: Native binary

Download the archive for your OS/arch from the server releases page (.tar.gz, .zip, or a .deb/.rpm that installs a systemd service), extract it, and run:

Terminal
# Choose the admin password in your browser instead of reading it from the log:
./audiosilo --setup --data ./data

# Or run headless - it auto-creates an admin and prints the password + auth code once:
AUDIOSILO_TLS_MODE=off ./audiosilo --data ./data

The --data directory holds the config, database and certs. The web player is embedded in the binary, so /web just works.

After it's running

By default the server listens on :8080 with a self-signed certificate. Open https://localhost:8080/admin to reach the admin console, or continue with the first-run guide to add a library and pair a device. To put it on the internet safely, see reverse proxy & TLS.

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