Audiobookshelf Docker quickstart: setup and first login

This starts a new Audiobookshelf server with Docker and connects SoundLeaf to it on your home network. You need Docker running on the computer that will host your library. If someone else hosts your server, ask them for its URL and your account details instead.

Start the server

Run this in a directory where you want to keep the server’s files. The four folders keep your media, settings and metadata outside the container so they survive container replacement.

# Create persistent folders before starting the container.
mkdir -p audiobooks podcasts config metadata

docker run -d \
  --name audiobookshelf \
  -p 13378:80 \
  --mount "type=bind,source=$(pwd)/audiobooks,target=/audiobooks" \
  --mount "type=bind,source=$(pwd)/podcasts,target=/podcasts" \
  --mount "type=bind,source=$(pwd)/config,target=/config" \
  --mount "type=bind,source=$(pwd)/metadata,target=/metadata" \
  -e TZ=America/Toronto \
  --restart unless-stopped \
  ghcr.io/advplyr/audiobookshelf:latest

Change America/Toronto to your timezone. Keep config on local storage; use the Docker Compose guide if you already have media folders elsewhere or want a configuration file to maintain. Don’t run this alongside an existing container with the same name or port.

Create the admin account

On the computer running Docker, open http://localhost:13378. A fresh server asks you to create its administrator account. Choose the username and password there; there isn’t a shared default password to copy from this guide.

If you see an ordinary login page instead, the server has already been initialized. Use that server’s existing account or ask its administrator. Reinstalling the app won’t reset a server password.

Add your first audiobook

1. Copy an audiobook into the audiobooks folder on the host.
2. In the server’s web interface, open Libraries and add a library with the Books media type.
3. Select /audiobooks as its folder. This is the path inside the container.
4. Save the library and run a scan, then check that the book appears and plays in the web interface.

Which server URL goes into SoundLeaf?

localhost means the device you’re using. On an iPhone, it points to the phone, not the computer running Docker.

Use the server computer’s local IP address and the published port, for example http://192.168.1.100:13378. Replace that example IP with your server’s address. Put the iPhone on the same network, check that the address opens in Safari, then enter it in SoundLeaf with your server username and password.

If Safari cannot reach it, check the server IP, port and host firewall first. If Safari works but the app doesn’t, use the connection troubleshooting guide.

Listen away from home

A local IP address normally works only on your home network. Use a VPN such as Tailscale or an HTTPS reverse proxy for remote access. SoundLeaf can keep separate home and away addresses.

For the server’s supported installation options, see the official Audiobookshelf documentation.