Audiobookshelf 2.38.0 upgrade: crash and access-control fixes
Summary
2.38.0 is a bug-fix release. It fixes several server crashes during library scans and saves. It also closes a group of permission gaps that matter if you share your server with other users. It adds no features.
Breaking changes and deprecations
The release notes list no breaking changes. One behaviour change is worth knowing about:
- Removing a book from a collection now needs the “update” permission instead of “delete”.
The notes also repeat a reminder that a new authentication system arrived in 2.26.0. If you are upgrading from an older version, read the discussion.
Tested in our lab
We started 2.37.2 with the documented Docker Compose layout and created the root user and one book library. We then stopped the container with docker compose down, changed the image tag to 2.38.0 and started it again.
- The log showed
Server upgrade detected from 2.37.2 to 2.38.0andNo migrations to run. /statusreportedserverVersion2.38.0, and the web root returned HTTP 200.- Login with the existing root user worked, and the library we created was still listed.
- The container log had no lines containing “error”.
We did not test the crash and permission fixes. Our test library had no media in it, and we only used one admin user.
Lab log
$ curl -s localhost:13378/status
{"app":"audiobookshelf","serverVersion":"2.37.2","isInit":false,"language":"en-us","authMethods":["local"],"authFormData":{"authLoginCustomMessage":""},"ConfigPath":"/config","MetadataPath":"/metadata"}
$ sudo docker compose down
[...]
Container abs-audiobookshelf-1 Removed
$ sed -i "s/2.37.2/2.38.0/" docker-compose.yml
$ sudo docker compose up -d
[...]
Container abs-audiobookshelf-1 Started
$ curl -s localhost:13378/status
{"app":"audiobookshelf","serverVersion":"2.38.0","isInit":true,"language":"en-us","authMethods":["local"],"authFormData":{"authLoginCustomMessage":""}}
$ sudo docker compose logs --tail 12
[...]
audiobookshelf-1 | [2026-11-18 08:12:12.363] INFO: [Database] Server upgrade detected from 2.37.2 to 2.38.0
[...]
audiobookshelf-1 | [2026-11-18 08:12:12.436] INFO: Listening on port :80
$ curl -s -o /dev/null -w "%{http_code}\n" localhost:13378/
200
$ sudo docker compose logs 2>&1 | grep -ci "error"
0
Reported by others
From the release notes. We did not verify these:
- Crashes fixed: scanning a book that lists the same author twice, a library scan hitting an existing series or book link, saving a book when a series or author link already exists (for example series names with emoji), and logout when OpenID is not configured.
- Access control fixes:
- Non-admin users could reach another user’s playback session.
- Media progress endpoints did not check library access.
- An empty library or tag allow list was treated as access to everything.
- Collection, RSS feed and notification socket events went to users who should not have received them.
- Other fixes: unauthenticated multipart uploads left temp files on disk, and local login threw an error when the username or password was not a string.
- Podcast episode descriptions and subtitles from audio tags are now sanitized.
Verdict
Upgrade now, especially if other people use your server. We saw a clean upgrade with data and login intact. Back up /config and /metadata first, as you would for any upgrade.
sources
other Audiobookshelf releases
- 2.37.2 upgrade now