Desktop: install and open
On Mac, open the DMG for your chip and drag Dibao into Applications. On Windows x64, run the EXE. The runtime is included; you do not need Node.js, Docker, or a separate database.
Current installers are unsigned, so your OS may ask you to confirm the first launch. On Mac, review it in System Settings > Privacy & Security. Use the official release assets and keep system security checks enabled.
NAS / Docker: an always-on home
Use Docker Compose on a NAS, home server, or VPS. The current image is ghcr.io/pls-1q43/dibao:v0.4.1, for amd64 and arm64. The Docker option opens the docs quick install guide.
Persist the whole /data directory. A LAN or private VPN is enough. For reliable PWA offline startup, use HTTPS outside localhost and prepare cached articles while connected.
Your first launch
Choose your language, then create a personal account. Import OPML or add RSS / Atom feeds now, or leave feeds and AI configuration for later.
Closing the desktop window keeps fetching active in the tray or menu bar. Quit stops the app. Desktop and NAS use separate data; remote-instance connections, imports between deployments, and multi-device sync are not available.
Backups and updates
Use Settings > About to create a backup, choose a dated restore point, or check for updates. Windows can restart to install after confirmation. On Mac, quit fully and replace the app using a new DMG. Upgrades back up local data first.
For Docker, sync pending offline actions, stop the service, and back up all of /data before upgrading. v0.4.0 to v0.4.1 adds no SQL migration or embedding recomputation. Earlier releases still apply pending migrations and data upgrades.