openreader/docs-site/docs/configure/database.md

title
Database

This page covers database mode selection for OpenReader WebUI.

Database mode

• SQLite (default): embedded DB at docstore/sqlite3.db; good for local/self-host single-instance setups.
• Postgres: enabled when POSTGRES_URL is set; recommended for production/distributed deployments.

What the database stores

• Document and audiobook metadata/state used by server routes.
• Auth/session tables when auth is enabled.

Related variables

• POSTGRES_URL

For database variable behavior, see Environment Variables.

Related docs

• Migrations
• Object / Blob Storage