PeerTube is the fediverse’s answer to centralized 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 decentralized web. This guide covers what PeerTube is, how it works, and how to launch your own instance in 2026.
What You’ll Know by the End
- What PeerTube is and how it fits into the fediverse
- The technical architecture behind decentralized video hosting
- Infrastructure requirements and cost considerations
- Step-by-step setup process for a PeerTube instance
- Federation, moderation, and community building on PeerTube
What PeerTube Is
PeerTube is a free, open-source video hosting platform that uses ActivityPub for federation. This means:
- Videos hosted on one PeerTube instance can be discovered and watched from other PeerTube instances
- Mastodon users can follow PeerTube channels and see new videos in their timelines
- Comments on PeerTube videos can come from Mastodon, Pleroma, or other ActivityPub platforms
- No single entity controls the network; anyone can run an instance
How It Differs from Centralized Platforms
No advertising: PeerTube instances are typically ad-free. Funding comes from donations, subscriptions, or the operator’s own resources.
No recommendation algorithm: PeerTube shows videos chronologically or by category. There is no engagement-maximizing algorithm pushing content at you.
Peer-to-peer delivery: PeerTube uses WebTorrent (or HLS) for video delivery. Viewers can optionally share bandwidth, reducing the load on the hosting server. This makes video hosting more feasible for small operators.
Community governance: Each instance sets its own rules about content, registration, and federation.
Infrastructure Requirements
Video hosting is resource-intensive. Be realistic about what you need:
Storage
Video files are large. Estimate 1–5 GB per hour of video depending on quality and encoding settings. Plan for:
- SSD or fast HDD for active content
- Object storage for archival content
- Regular cleanup policies for unused content
Bandwidth
Video streaming consumes significant bandwidth:
- A single HD stream can use 3–8 Mbps
- Multiple concurrent viewers multiply this
- Peer-to-peer delivery helps but does not eliminate server bandwidth needs
Compute
Transcoding (converting uploaded videos into multiple quality levels) is CPU-intensive:
- 4+ CPU cores recommended
- Transcoding can be offloaded to a separate worker
- Consider hardware-accelerated transcoding (GPU) for busy instances
Estimated Monthly Costs
For a small instance (50–200 videos, moderate traffic): expect hosting costs comparable to a medium VPS plus storage costs. Bandwidth can be the wild card — a single viral video can spike costs significantly.
Setup Process
1. Server Preparation
Start with a fresh Linux server (Debian/Ubuntu recommended):
- 4+ CPU cores, 8 GB RAM minimum
- Install dependencies: Node.js, PostgreSQL, Redis, FFmpeg, Nginx
- Configure firewall and TLS (Let’s Encrypt)
2. PeerTube Installation
PeerTube supports Docker and bare-metal installation:
- Clone the PeerTube repository
- Configure the production environment
- Run database migrations
- Set up the admin account
3. Transcoding Configuration
Configure transcoding quality levels and performance:
- Choose which resolutions to transcode to (240p, 360p, 480p, 720p, 1080p)
- Enable/disable HLS and WebTorrent
- Set concurrent transcoding limits based on your CPU capacity
4. Federation Setup
Once running:
- Your instance can follow other PeerTube instances
- Mastodon users can follow your channels
- Configure which instances to federate with
- Set up auto-follow policies if desired
5. Customization
- Brand your instance (logo, banner, description)
- Define content categories
- Set registration policies
- Create initial channels and upload content
Federation with Mastodon
PeerTube’s federation with Mastodon is one of its most compelling features:
Following channels: Mastodon users search for a PeerTube channel handle and follow it. New video uploads appear as posts in their Mastodon timeline.
Commenting: Mastodon users can reply to a PeerTube video post, and their comment appears on the PeerTube video page. This cross-platform interaction is seamless when it works well.
Sharing: Boosting a PeerTube video on Mastodon shares it with your followers, driving discovery.
Limitations: Not all interaction features translate perfectly. Like counts, emoji reactions, and some comment threading may behave differently across platforms.
Content Moderation
Running a video platform brings moderation challenges:
Proactive Measures
- Require account approval for uploads
- Set file size and video length limits
- Implement automated checks for known illegal content (if applicable in your jurisdiction)
- Use federation to leverage other instances’ moderation efforts
Reactive Moderation
- Enable user reporting
- Review flagged content promptly
- Remove content that violates your terms
- Defederate from instances that host problematic content
Legal Considerations
- Understand your jurisdiction’s liability for user-uploaded content
- Maintain a DMCA (or equivalent) takedown process
- Keep logs for legal compliance but minimize data retention
See our developer notes for more on moderation systems design.
Building a Community
A PeerTube instance needs content and viewers to thrive:
- Start with a niche: Focus on a specific content area (education, FOSS, local community)
- Seed with quality content: Upload initial content to give the instance purpose
- Promote on Mastodon: Cross-promote your PeerTube instance to your Mastodon network
- Engage with other instances: Follow and interact with PeerTube channels on other instances
- Make it easy to contribute: Clear guidelines, simple upload process, responsive admin
Common Mistakes
- Underestimating storage costs: Video storage grows fast; plan for object storage early
- Enabling all transcoding resolutions immediately: Start with 2–3 common resolutions and add more as you understand your capacity
- Ignoring bandwidth costs: A popular video can spike bandwidth significantly; set up CDN or peer-to-peer delivery
- Running PeerTube on the same server as Mastodon: Transcoding is CPU-intensive and will degrade Mastodon performance
- Not moderating uploads: Even small instances need content review policies
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. This is one of the best examples of fediverse interoperability.
How does peer-to-peer video delivery work? PeerTube can use WebTorrent to have viewers share bandwidth. When enabled, viewers’ browsers share video chunks with other viewers, reducing server load. Users can opt out of P2P sharing.
Can I monetize content on PeerTube? PeerTube does not have built-in monetization. Some creators link to external donation platforms (Patreon, Liberapay). Some instances experiment with paid access, but this is not a core feature.
How many viewers can a PeerTube instance handle? This depends on your server specs, 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 good for live streaming? PeerTube has experimental live streaming support. It works for small audiences but is less mature 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. Plan for re-encoding and metadata migration. See our articles hub for migration guides.