Server Guides

Everything you need to set up and maintain your Audiobookshelf server.

Troubleshooting

Audiobookshelf crashes after a quick match and won't stay up

Fix the SequelizeUniqueConstraintError on bookSeries that crashes Audiobookshelf into a Docker restart loop after a quick match

Published
Running Audiobookshelf as a non-root user in Docker

Fix EACCES permission denied errors when running Audiobookshelf Docker with user: 1000:1000 by pre-creating config and metadata directories

Published
Audiobookshelf won't import books from LibbyRip

Why Audiobookshelf scans fail or skip LibbyRip-ripped audiobooks, and how to fix the metadata.json so the books show up.

Published
Audiobookshelf audio goes silent after the first chapter

Fix M4B audiobooks that play Chapter 1 fine then go silent when the channel count or sample rate changes between chapters

Published
Why Audiobookshelf library scans take hours on network storage

Fix slow Audiobookshelf scans on CIFS, SMB, NFS, and NAS setups caused by transient inode values triggering unnecessary ffprobe re-scans

Published
Audiobookshelf stops working after a reboot

Fix Audiobookshelf failing to load or stream books after rebooting a Docker host by making Docker wait for your external drive or NAS mount.

Published
Why Audiobookshelf keeps logging you out

Fix the frequent re-login problem in Audiobookshelf v2.26+ caused by JWT session management, reverse proxy timeouts, and lost refresh tokens

Updated
Audiobookshelf won't start after a Docker upgrade

Fix the Cannot find module /index.js crash after upgrading Audiobookshelf Docker to v2.22.0+ by removing working_dir and recreating the container

Published
New audiobooks getting the wrong metadata in Audiobookshelf

Fix the bug where newly added audiobooks steal metadata from existing books due to inode collisions on NAS and network shares

Published
Audiobookshelf stops playing between chapters on iOS

Why audiobook playback stops at the end of each track on iOS Safari and how to fix it with single-file M4B books or a native app

Published