rpodder

A modern, fast, gpodder.net-compatible podcast sync server written in Rust.

Sync your podcast subscriptions and episode progress across AntennaPod, gPodder, Kasts, and any client that supports the gpodder.net API.

Features

• Full gpodder API — subscriptions, episode actions, devices, sync groups, settings, favorites, chapters, podcast lists
• Web UI — built-in Svelte 5 + Tailwind interface for browsing, searching, and managing podcasts
• User roles — admin/user system with first-user auto-admin, full user management panel
• SSO/OAuth2 — OIDC single sign-on (Authentik, Keycloak, etc.) with group-based admin mapping
• Registration control — open, closed, or invite-only (email activation)
• Password management — self-service change/reset via email, admin set/reset, SSO-friendly
• HTTPS upgrade suggestions — detects HTTP subscriptions with HTTPS alternatives, proposes upgrade
• Multi-format — JSON, OPML, and TXT for subscription import/export
• Dual database — PostgreSQL for scale, SQLite for self-hosting
• Feed indexing — automatic feed fetching, parsing, fuzzy search, podcast directory
• Dynamic migrations — reads all *.up.sql from migrations directory, no hardcoded filenames
• Privacy — private/paid feeds (with tokens in URL) hidden from public directory
• Lightweight — single binary with embedded UI, low memory footprint

Quickstart

SQLite (self-hosted)

# Build
cargo build --release

# Initialize database and create an admin user
./target/release/rpodder migrate
./target/release/rpodder user create myuser mypassword --admin

# Start the server
./target/release/rpodder serve

The server starts on http://localhost:3005. Point your podcast app at this URL.

Docker (SQLite)

docker compose --profile sqlite up -d
# Create a user
docker compose exec rpodder-sqlite rpodder user create myuser mypassword --admin

Docker (PostgreSQL)

docker compose --profile release up -d

Configuration

All settings can be set via environment variables or a TOML config file:

Or use a config file: rpodder -c config.toml serve

See config/rpodder.example.toml for an example.

CLI

rpodder serve                                    # Start the server
rpodder migrate                                  # Run database migrations
rpodder user create <username> <password>         # Create a user
rpodder user create <username> <password> --admin # Create an admin user
rpodder user delete <username>                    # Deactivate a user
rpodder repair                                   # Rebuild FTS5 index (SQLite)

Client Setup

AntennaPod

Settings → Synchronization → Choose provider → gpodder.net Server: http://your-server:3005 • Username/Password as created above

Kasts (KDE)

Settings → Synchronization → Custom server http://your-server:3005

gPodder Desktop

Preferences → gpodder.net → Server URL: http://your-server:3005

API Endpoints

See docs/API_REFERENCE.md for the complete API surface.

Systemd

sudo cp target/release/rpodder /usr/local/bin/
sudo cp config/rpodder.service /etc/systemd/system/
sudo useradd -r -s /bin/false rpodder
sudo mkdir -p /var/lib/rpodder /usr/share/rpodder
sudo cp -r migrations /usr/share/rpodder/
sudo chown rpodder:rpodder /var/lib/rpodder
sudo systemctl enable --now rpodder

License

AGPL-3.0-or-later