PeerTube is the fediverse’s answer to centralised video platforms. It lets you host and share video on your own terms, with federation built in so your content can reach audiences across the decentralised web. This article covers what PeerTube is, how its architecture works, what it actually costs to run, and how to get an instance online in 2026.
PeerTube and the Fediverse
PeerTube is a free, open-source video hosting platform that uses ActivityPub for federation. In practical terms, that means videos hosted on one PeerTube instance can be discovered and watched from any other PeerTube instance. Mastodon users can follow PeerTube channels and see new uploads in their timelines. Comments can arrive from Mastodon, Pleroma, or any other ActivityPub-compatible platform. No single entity controls the network, and anyone with a server can run an instance.
What makes this genuinely different from YouTube or Vimeo is not just the technology - it is the governance model. PeerTube instances are typically ad-free, funded by donations, subscriptions, or the operator’s own budget. There is no engagement-maximising recommendation algorithm; videos surface chronologically or by category. Each instance sets its own rules about content, registration, and which other instances it federates with.
Video delivery works through WebTorrent or HLS. When WebTorrent is enabled, viewers’ browsers can share video chunks with other viewers, which reduces the load on the hosting server. This is what makes PeerTube feasible for small operators - a popular video does not necessarily collapse your server, because some of the bandwidth burden shifts to the audience. That said, P2P delivery does not eliminate server costs. It reduces them.
Infrastructure Requirements
Video hosting is resource-intensive in ways that text-based services simply are not. It is worth being honest about this before you commit to running an instance.
Storage
A single hour of video typically runs 1 to 5 GB depending on quality and encoding settings. Storage needs compound quickly. Fast SSD or HDD suits active content; object storage makes more sense for archival material. Build in a cleanup policy early - unused or unpublished videos accumulate silently and you will not notice until you are out of space.
Bandwidth
This is where costs can spiral without warning. A single HD stream uses 3 to 8 Mbps. Multiply that by concurrent viewers and the numbers get uncomfortable fast. One popular video can spike bandwidth costs by 300% over a weekend. Peer-to-peer delivery helps, but it is not a ceiling on your bills. Make sure you understand your hosting provider’s bandwidth pricing before a video unexpectedly goes viral.
Compute
Transcoding - converting uploaded videos into multiple quality levels - is CPU-intensive work. Four or more CPU cores is a practical minimum. Transcoding can be offloaded to a separate worker process, and hardware-accelerated transcoding via GPU is worth considering for busier instances, though it adds both cost and configuration complexity.
What to Budget
For a small instance running 50 to 200 videos with moderate traffic, expect costs comparable to a medium VPS plus storage. Bandwidth is the unpredictable variable. A single viral video can push costs into triple digits for the month. Plan for that possibility before it happens, not after.
Setting Up a PeerTube Instance
Server Preparation
Start with a fresh Linux server - Debian and Ubuntu are the most reliably documented options. You need at least 4 CPU cores and 8 GB of RAM. Beyond the hardware, you will need Node.js, PostgreSQL, Redis, FFmpeg, and Nginx installed, a configured firewall, and TLS sorted (Let’s Encrypt works fine).
Installation
PeerTube supports both Docker and bare-metal installation. Both routes work. Docker is simpler to keep updated over time. The process involves cloning the PeerTube repository, configuring the production environment, running database migrations, and creating the admin account. None of it is exotic, but it does assume comfort with a Linux command line.
Transcoding Configuration
This is where most new operators make avoidable mistakes. Do not enable every resolution immediately. Start with two or three common ones - 480p, 720p, and 1080p if your CPU can handle it - then expand as you understand your transcoding queue. Enabling six resolution variants for every upload will crush your CPU. You can choose between HLS and WebTorrent, and you should set concurrent transcoding limits based on actual capacity rather than what sounds reasonable in theory.
Federation Setup
Once the instance is running, you can follow other PeerTube instances, allow Mastodon users to follow your channels, configure which instances you federate with, and set up auto-follow policies if you want them. Federation does not configure itself. You need to make deliberate choices about which parts of the network you want to connect with, and which you do not.
Customisation
An empty instance looks abandoned. Before you open registration, upload a logo and banner, write a clear description, define content categories suited to your niche, and set your registration policy. Upload at least some content. If someone visits and finds nothing to watch, they leave and do not come back.
How Federation with Mastodon Actually Works
PeerTube’s federation with Mastodon is one of its most practically useful features - and one of the more confusing ones for users who have not encountered it before.
Mastodon users can search for a PeerTube channel handle and follow it directly. New uploads then appear as posts in their Mastodon timeline. When a Mastodon user replies to one of those posts, the comment appears on the PeerTube video page. Boosting a PeerTube video on Mastodon shares it with the booster’s followers, which drives discovery in a way that no algorithm can replicate.
That said, not all interaction features translate cleanly across platforms. Like counts, emoji reactions, and comment threading can behave differently depending on which platform a user is posting from. This confuses people. Expect occasional support requests from users who cannot work out why their comment did not appear, or why the like count looks wrong.
Content Moderation
Running a video platform is a moderation commitment. Video is harder to moderate than text - you cannot skim a video the way you can skim a post.
Proactively, it makes sense to require account approval before allowing uploads, set file size and video length limits, implement automated checks for known illegal content where your jurisdiction requires it, and use federation relationships to benefit from other instances’ moderation work.
Reactively, you need user reporting enabled, a process for reviewing flagged content promptly, and a clear policy on defederating from instances that consistently host problematic material.
The legal dimension varies significantly by country. Understand your local liability rules for user-uploaded content before you open registration. Maintain a DMCA-equivalent takedown process. Keep logs for legal compliance, but minimise data retention beyond what you actually need.
See our developer notes for more on moderation systems design.
Building a Community on PeerTube
Content and viewers need to arrive together, more or less. One without the other stalls quickly.
Focus on a specific niche from the start - FOSS tutorials, local community news, educational content in a particular discipline. Generic instances struggle to attract either creators or regular viewers. Starting narrow and growing outward is a more reliable path than trying to be everything at launch.
Seed the instance with quality content before you promote it. Cross-promote through your Mastodon network; the federation advantage only works if people know you exist. Follow and interact with channels on other PeerTube instances - federation is a two-way relationship. And make it easy for people to contribute. If uploading a video requires 20 minutes of form-filling and unclear instructions, creators will not bother.
Common Mistakes
Underestimating storage growth is the most common early error. Video storage fills up faster than operators expect. Plan for object storage before you need it, not once your VPS is already full.
Enabling all transcoding resolutions at launch is the second. Transcoding six versions of every video is a reliable way to make your server unresponsive. Start with two or three resolutions and add more once you understand your actual capacity.
Ignoring bandwidth costs catches people off guard. A popular video can spike bandwidth significantly. Set up a CDN or confirm that peer-to-peer delivery is working correctly before you need it.
Running PeerTube on the same server as a Mastodon instance is a bad idea. Transcoding is CPU-intensive and will degrade Mastodon performance. Separate servers are worth the extra cost.
Not having upload moderation policies in place from day one is the other mistake that causes real problems. Even small instances need content review. Claiming ignorance is not a legal defence if someone uploads something illegal.
Frequently Asked Questions
Can Mastodon users comment on PeerTube videos?
Yes. When a Mastodon user replies to a PeerTube video post in their timeline, the comment appears on the video page. It is one of the clearest demonstrations of how ActivityPub federation works across different platforms.
How does peer-to-peer video delivery work?
PeerTube can use WebTorrent so that viewers’ browsers share video chunks with other viewers, reducing the load on the hosting server. Users can opt out of P2P sharing if they prefer not to contribute bandwidth.
Can I monetise content on PeerTube?
There is no built-in monetisation. Some creators link to external donation platforms such as Patreon or Liberapay. Some instances experiment with paid access, but this is not a core feature and requires additional setup outside of PeerTube itself.
How many concurrent viewers can a PeerTube instance handle?
This depends on server specs, available bandwidth, and whether P2P delivery is enabled. A well-configured instance with CDN and P2P can handle hundreds of concurrent viewers. Check our tools page for hosting resources.
Is PeerTube suitable for live streaming?
PeerTube has live streaming support, but it is still maturing. It works for small audiences, though it is less reliable than dedicated streaming platforms. Development is ongoing.
Can I migrate videos from another platform to PeerTube?
PeerTube supports video import from URLs. Bulk migration tools vary in quality, and you should plan for re-encoding and metadata migration as separate tasks. See our articles hub for migration guides.