Storyteller

Overview

Storyteller is a self-hosted platform for creating and reading ebooks with guided narration. It's made up of two components: the alignment server, and the mobile apps. Together, these components allow you to take audiobooks and ebooks that you already own and automatically align them, as well as read or listen to (or both!) the resulting aligned books.

Align your audiobooks and ebooks

Switch back and forth between listening and reading without losing your place, or have Storyteller read aloud to you while highlighting the text!

Read or listen however you choose

Storyteller produces EPUB 3 compliant ebook files. You can read them with any ebook reader (software or hardware!) that supports EPUB Media Overlays, or you can use the dedicated Storyteller mobile apps.

Own your books

Storyteller is completely self-hosted. All of your books stay on your hardware, and you're free to move, copy, and back them up as needed.

AMD HW ACCELERATED TRANSCRIPTION:

To enable support for HW Accelerated transcription, add the "--device='/dev/dri'" parameter added to "Extra Parameters:"

NVIDIA GPU:

To enable NVIDIA GPU support, ensure that you have installed the Nvidia-Driver plugin and add the "--runtime='nvidia'" parameter added to "Extra Parameters:"

AMD GPU:

To enable AMD GPU support, ensure that you have installed the Radeon-TOP plugin.

Requirements

Nvidia-Driver plugin (nVidia Support)
Radeon-TOP plugin (AMD Support)

Runtime arguments

Web UI: http://[IP]:[PORT:8001]/
Network: bridge
Shell: sh
Privileged: false

Template configuration

App DataPathrw

Where to store the Storyteller sqlite db file and other configuration files

Target: /data
Default: /mnt/user/appdata/storyteller

Data directoryVariable

Where Storyteller should look for the data directory _within_ the container. This should match the Container path for the App Data path -- there's no need to change it.

Target: STORYTELLER_DATA_DIR
Default: /data
Value: /data

AssetsPathrw

Where to store the Storyteller media assets (the uploaded and aligned EPUB and audio files)

Target: /data/assets

Auth secretVariable

A cryptographically random secret key, used to encrypt Storyteller's authentication tokens. See the docs here https://storyteller-platform.gitlab.io/storyteller/docs/installation/self-hosting#secrets for guidance.

Target: STORYTELLER_SECRET_KEY

Web server portPorttcp

The port that the web server will listen on

Target: 8001
Default: 8001
Value: 8001

Radeon driver version overrideVariable

If you have an AMD GPU that has a driver version that is unsupported by your Unraid AMD driver, you may be able to work around it by setting this variable to a supported version number. E.g. for an AMD Radeon RX 6700 XT, this value must be set to 10.3.0

Target: HSA_OVERRIDE_GFX_VERSION
Default: 10.3.0

Links

Template Registry Project

Details

Repository

registry.gitlab.com/storyteller-platform/storyteller:latest

Registry

https://gitlab.com/storyteller-platform/storyteller/-/releases

Last Updated2026-06-01

First Seen2025-03-14

Run Storyteller on Unraid.

Storyteller is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS