Run a Node

If you have a mini-PC (i.e. Raspberry Pi), an old computer, or an advanced server, you can run a node to host podcast episodes.


"Easy"

The easiest & most reliable way to run a node is using Umbrel OS with the IPFS Podcasting App.

1. Visit https://umbrel.com/#start for instructions installing Umbrel OS on a Raspberry PI or any Debian or Ubuntu based PC.

2. Install the IPFS Podcasting app from the Umbrel App store.

Optionally enter your email inside the app to manage your node from the website.


"Advanced"

You can setup Linux & IPFS yourself, and run the IPFS Podcasting script to join the network & request work.

Pre-Installed IPFS

If you already have an IPFS server, you only need to run a client script every 10 minutes (via cron) to request & process podcast episodes.

1. Download the client script.

2. Create a cron task to run the script every 10 minutes using flock to prevent multiple instances. You may optionally include your email address in the cron task to manage your node from the website.

*/10 * * * * cd ~/ && /usr/bin/flock -n /tmp/ipfspodcastnode.lockfile ~/ipfspodcastnode.py email@example.com

Install Script

If you don't have IPFS installed, this Install Script will install the latest IPFS software, IPFS Podcasting client script, and setup a cron task on your Debian or Ubuntu based PC (preferred).

1. Download the install script.

2. Run the script with sudo bash ipfspodcasting-install.sh.

Post Install

An ipfspodcastnode.log log file will be created to monitor activity.

If you've configured your email, you can create an account to manage your node and "Favorite" feeds to support a podcast feed with long term hosting.

You can view participating nodes to find your node stats (using your IPFS ID).


Troubleshooting & Support

For support, you can email support@ipfspodcasting.net, submit an issue on GitHub (Umbrel / Python), or ask for help @Cameron on Mastodon @podcastindex.social.