Documentation
PodVault is a self-hosted podcast archiver. It downloads episodes from RSS feeds or Apple Podcasts links, organizes them into a clean folder tree, writes complete tags and cover art, and keeps them safe for the long run. You manage it from a web dashboard or the command line, and you can listen to the archive from any podcast app through PodVault’s own feeds.
It runs as a single Docker container with a single data volume, and it’s meant for your home network.
Start here
Section titled “Start here”Quick startRun the Docker image, add a podcast and download your first episode.
InstallationDocker (recommended) or from source with pip.
Use it
Section titled “Use it”Web interfaceLibrary, podcast and episode pages, Queue, Schedule, Activity, Storage, Settings and the player.
Command lineEvery podvault subcommand, for scripts and terminals.
Podcast app feedsListen to your archive in Apple Podcasts, Overcast, Pocket Casts, AntennaPod…
OPML import & exportMove your subscriptions in from another app, or take them with you.
Archive safetyIntegrity checks, episodes kept after they leave the feed, backups and export.
Configure it
Section titled “Configure it”App configurationNaming templates and every PODVAULT_* environment variable.
DockerVolumes, Compose, ports, health check, updates and a separate audio disk.
SecurityThe security model, the optional login, and why PodVault stays off the internet.
TroubleshootingFixes for common problems.
DevelopmentArchitecture, project layout, running from source and tests.
Release notesWhat changed in each release.