Linux

Where Does Newsboat Store Feeds and Cache?

Newsboat centers on ~/.newsboat with urls, config, and cache.db. The flags that relocate each.

Last updated

Newsboat keeps urls, config, and cache.db together in ~/.newsboat by default. First launch refuses to start until urls exists, which is the fastest way to confirm the folder. Search history (history.search) and lock files share it.

Flags relocate each piece: -u for urls, -C for config, -c for cache. The cache-file config key even allows ~/.local/share style splits. Back up urls plus cache.db to migrate read state; config travels as plain text alongside.

Where Newsboat stores this, by platform

Linux
~/.newsboat/urls

Feed list; config and cache.db beside it. -u/-C/-c flags override per file. Lock urls down to 600 when feeds carry basic auth passwords.

Frequently asked questions

how do i back up newsboat

Copy ~/.newsboat (urls, config, cache.db) with newsboat closed. The cache holds read state, so skipping it loses unread tracking but keeps feeds.

newsboat says no urls configured, where is the file

Create ~/.newsboat/urls with one feed URL per line, or import with newsboat -i blogroll.opml. The error message prints the exact path it expects.

Notice an outdated path? Let us know.