A self-hosted, single-user live video streaming and chat server that lets you run your own streams with built-in chat.
- 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
Read the production install guide for your OS
- 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
A self-hostable, federated social network server built on ActivityPub, letting users follow and interact across independent Mastodon and other Fediverse servers.
An open source, federated social media platform (microblogging) that runs on the ActivityPub fediverse protocol.
Pixelfed is an open-source, ad-free photo sharing platform that federates with the fediverse via ActivityPub.
A federated short video sharing platform, self-hostable and connected to the ActivityPub social web (Mastodon, Pixelfed).
A pure Go implementation of the WebRTC API for building real-time audio, video and data peer-to-peer connections.