Mirror of PeerTube
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Chocobozzz 4aeb67a569
Improve dockerfile
2 years ago
.github Try to improve the contributing guide for tests 2 years ago
client Improve big play button animation 2 years ago
config Misc. typos 2 years ago
scripts Upgrade to webpack 4 2 years ago
server Add auth documentation 2 years ago
shared Add publishedAt field for video model. 2 years ago
support Improve dockerfile 2 years ago
.codeclimate.yml Fetch outbox to grab old activities 2 years ago
.dockerignore Improve dockerfile 2 years ago
.editorconfig add .editorconfig to maintain consistent coding styles (#429) 2 years ago
.gitignore Fix nginx configuration that do not work with import-videos script 2 years ago
.travis.yml Add redis for travis 2 years ago
ARCHITECTURE.md Try to improve documentations/readme 2 years ago
CHANGELOG.md Fix changelog 2 years ago
CODE_OF_CONDUCT.md Add `etc` on some points of the CoC (#305) 2 years ago
CREDITS.md Update code contributors list 2 years ago
FAQ.md Add "Can I seed videos with my classic BitTorrent client" in FAQ 2 years ago
LICENSE Change licence to AGPL 3 years ago
README.md Improve readme 2 years ago
package.json Upgrade server dependencies 2 years ago
server.ts Don't start application until all components were initialized 2 years ago
tsconfig.json Add ability to reset our password 2 years ago
tslint.json Fix lint momory issues 2 years ago
yarn.lock Upgrade server dependencies 2 years ago



Federated (ActivityPub) video streaming platform using P2P (BitTorrent) directly in the web browser with WebTorrent.

PeerTube is sponsored by Framasoft, a non-profit that promotes, spreads and develops free culture in general, and free-libre software in particular. If you want to support this project, please consider donating to them.

Dependency Status devDependency Status

Build Status Dependencies Status devDependency Status JavaScript Style Guide PeerTube Freenode IRC


Website | Instances list


Want to see it in action?


We can’t build a FOSS video streaming alternatives to YouTube, Dailymotion, Vimeo… with a centralized software. One organization alone may not have enough money to pay for bandwidth and video storage of its servers.

So we need to have a decentralized network of servers seeding videos (as Diaspora for example). But it’s not enough because one video could become famous and overload the server. It’s the reason why we need to use a P2P protocol to limit the server load. Thanks to WebTorrent, we can make P2P (thus BitTorrent) inside the web browser, as of today.


  • nginx
  • PostgreSQL
  • Redis
  • NodeJS >= 8.x
  • yarn
  • OpenSSL (cli)
  • FFmpeg >= 3.x

Run using Docker

See the docker guide


See the production guide.


See the contributing guide to see how to test or contribute to PeerTube. Spoiler alert: you don’t need to be a coder to help!

API REST documentation

For now only on Github:



If you have a question, please try to find the answer in the FAQ first.


See ARCHITECTURE.md for a more detailed explanation.


  • The backend is a REST API.
  • Servers communicate with each others with Activity Pub.
  • Each server has its own users who query it (search videos, query where the torrent URI of this specific video is…).
  • If a user uploads a video, the server seeds it and sends its followers some metadata (name, short description, torrent URI…).
  • A server is a tracker responsible for all the videos uploaded in it.
  • Even if nobody watches a video, it is seeded by the server (through WebSeed protocol) where the video was uploaded.

Here are some simple schemes:

Decentralized Watch a video Watch a P2P video


Copyright © 2018 PeerTube Contributors

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.