Getting started

Pebblefeed runs on Linux, macOS and FreeBSD. It needs no external database — everything is stored in a single SQLite file.

Install

tar xzf pebblefeed-1.8.2-linux-amd64.tar.gz
sudo install pebblefeed /usr/local/bin/
pebblefeed init --data /var/lib/pebblefeed
pebblefeed serve --listen 127.0.0.1:7080

On first start you'll be asked to create an admin account. Put a reverse proxy (nginx, Caddy) in front of it if you want HTTPS.

Configuration

Settings can be passed as flags or in /etc/pebblefeed.toml:

listen        = "127.0.0.1:7080"
data_dir      = "/var/lib/pebblefeed"
refresh_every = "30m"
fetch_full_text = false
max_items_per_feed = 500

Importing feeds

pebblefeed import --opml subscriptions.opml

Backups

Stop the service and copy pebblefeed.db, or use pebblefeed backup --out file.db while it's running.

Mobile clients

Enable the Fever API in settings, then point any compatible client at https://your-host/fever/.