Repolode
Chocobozzz

Chocobozzz/PeerTube

Self-hostable, ActivityPub-federated video platform where independent instances share content and use WebRTC P2P to lighten server load.

Open-source alternative to:YouTubeVimeo

Stars
15,361
Forks
1,847
Open issues
698
Last commit
8 days ago

What is it?

PeerTube is a video hosting platform that anyone can run on their own server. Instead of a single company hosting all videos, it is made of many independent instances that federate with each other over ActivityPub, so a creator on one instance can be followed and their videos discovered from other instances and from Fediverse software such as Mastodon.

Viewers' browsers can exchange video data with each other over WebRTC, reducing the bandwidth load on the instance serving a video. Instances can also cache each other's videos, so smaller servers can reach a wider audience. Creators can upload videos, host live streams, embed a player on other websites, and add a support button linking to their donation accounts.

The project is written in TypeScript with an Angular web client, and it offers a REST API, an OpenAPI schema, command-line tools for importing and uploading videos, and Docker and other community install options.

Key features

  • 01Federates with other instances and Fediverse software over ActivityPub
  • 02Uses WebRTC peer-to-peer to share video load between viewers
  • 03Supports video uploads and live streaming
  • 04Lets instances cache each other's videos for redundancy
  • 05Provides a REST API with an OpenAPI schema and CLI import tools

Use cases

  • Running a community or organization video server without relying on YouTube or Vimeo
  • Hosting educational or public-interest video libraries on a self-managed instance
  • Letting creators publish once and be followed from Mastodon and other Fediverse apps
  • Embedding a self-hosted video player on an existing website

Quick start

  1. 1

    Read the production install guide for your OS

  2. 2

    Check community packages (YunoHost, Docker) as an alternative

Things to know

  • Running your own instance requires a dedicated server and some sysadmin work.
  • The README's recommended install is a full production setup, not a one-line install.

In collections

Topics

FAQ

What is PeerTube?
Self-hostable, ActivityPub-federated video platform where independent instances share content and use WebRTC P2P to lighten server load. PeerTube is a video hosting platform that anyone can run on their own server. Instead of a single company hosting all videos, it is made of many independent instances that federate with each other over ActivityPub, so a creator on one instance can be followed and their videos discovered from other instances and from Fediverse software such as Mastodon.
Is PeerTube free to use? What license does it have?
PeerTube is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is PeerTube still maintained?
Actively maintained. The last commit to PeerTube was on Oct 16, 2026.
What can I use PeerTube for?
Running a community or organization video server without relying on YouTube or Vimeo Hosting educational or public-interest video libraries on a self-managed instance Letting creators publish once and be followed from Mastodon and other Fediverse apps Embedding a self-hosted video player on an existing website
How do I install PeerTube?
Read the production install guide for your OS Check community packages (YunoHost, Docker) as an alternative
Where can I get PeerTube?
The source code and installation instructions are on GitHub: https://github.com/Chocobozzz/PeerTube

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects