Skip to content

en US Configuration

六面体 edited this page Sep 16, 2026 · 6 revisions

Common Settings

Home · 简体中文

Settings in the app

These are web navigation paths. Some options require administrator or system-management permissions.

What you want to do Where to go
Add libraries, change scan rules, view imports Settings → Library Sources & Imports
Fill in titles, authors, and covers automatically Settings → Smart Organization
Set sending email and Kindle recipient addresses Settings → Email & Kindle
Connect a third-party reader Settings → OPDS
Create or restore a backup Settings → Data & System
Manage accounts and library access Settings → User Management
Check updates and the current version Settings → About
Investigate a problem Settings → System health check / System Logs

Adjust font size, themes, and page-turning options inside the reader. For Kindle and other readers, see the User Guide.

Change the Docker port

With the Quick Start compose.yaml, change the left side of "3000:3000" to an unused port, such as "3080:3000". Save, run docker compose up -d, and open http://server-address:3080.

On fnOS, change the port in the application's settings.

Use existing book folders

Change the library mounts in compose.yaml to your actual folders, for example:

volumes:
  - ./data/storage:/app/storage
  - /srv/books:/libraries/books
  - /srv/comics:/libraries/comics

Save and run docker compose up -d. Add /libraries/books and /libraries/comics in the app, rather than the server paths on the left. Keep the original app-data mount; adding another library does not require replacing data/storage.

Folder permissions

The app needs read/write access to data/storage and read access to libraries. Uploading and deleting original files also require library write access. The Quick Start uses 1000:1000. If your NAS folders belong to another user, create .env beside compose.yaml with the actual user and group IDs:

PUID=1000
PGID=1000

Grant the matching access in the NAS folder permissions, then run docker compose up -d.

Use a domain or install the web app

In your NAS reverse-proxy settings, forward an HTTPS domain to the Ermao Books access port. Check that you can sign in and open books through it before using it on your phone or in OPDS. HTTPS is required for full web-app installation and caching; HTTP remains usable for ordinary local browsing.

Clone this wiki locally