Skip to content

Getting Started

Leelaa Reader is a self-hosted audiobook platform. First-time setup has three stages:

  1. Deploy the server;
  2. Sign in and add your audiobook storage;
  3. Choose a client and connect it to the server.

This page provides the shortest path. Detailed deployment, installation, and connection steps are kept in dedicated tutorials.

1. Choose a server deployment

Both methods expose the same service:

text
http://server-ip:8686

The Docker image supports linux/amd64 and linux/arm64. An exec format error usually means the image architecture does not match the device.

2. Complete first-time setup

  1. Open http://server-ip:8686;
  2. Sign in with the administrator account;
  3. Complete activation when prompted;
  4. Add a local folder, WebDAV source, cloud-drive WebDAV bridge, or podcast RSS feed;
  5. Start a scan and wait for books and chapters to appear;
  6. Open a book and confirm that a chapter can play.

Data persistence

Docker deployments must persist /data. On fnOS, ensure that the application has read/write permission for its database directory.

3. Choose a client

Choose the device you use. Each tutorial includes installation, server address configuration, and sign-in steps.

4. Remote access and HTTPS

Use a reverse proxy and HTTPS for remote access. Do not expose an unencrypted 8686 port directly to the public internet.

Common options include Lucky, Nginx Proxy Manager, Nginx, and built-in NAS reverse proxies. The upstream target is normally:

text
http://127.0.0.1:8686

After HTTPS is configured, enter the HTTPS domain in native clients.

Next steps