Where it runs
Mac minis, home NAS boxes, VPS instances, or any host that can keep Docker running are good fits. The default entrypoint starts an HTTP process and a separate worker for ingestion, ranking, and plugin tasks.
It does not need to be public on the internet. A LAN or private VPN deployment is enough. v0.3.1 also improves private/local-network feed discovery and refresh for NAS, home-network, and self-hosted RSS use cases.
First launch
A fresh instance walks through single-user login creation, OPML import or the first RSS / Atom feed, and optional provider setup.
Skipping the provider still leaves reading, search, favorites, read later, and baseline ranking available.
Data ownership
Feeds, articles, states, behavior events, reading profile, recommendation v3 memory, embedding authority table, and index state live in your SQLite database and persistent directory.
Upgrading directly from v0.2.1 to v0.3.1 adds recommendation v3 memory structures. Upgrading from v0.3.0 to v0.3.1 adds no core SQLite migration and does not require embedding recomputation.
Install entry point
Start from the docs quick install page. The recommended image is ghcr.io/pls-1q43/dibao:v0.3.1.
If installation fails or the docs are unclear, open a thread in GitHub Issues.