Frequently Asked Questions

PeerTube is a tool that you install on a web server. It allows you to create a video hosting website, so create your "homemade YouTube".

Отличие от YouTube заключается в том, что он не предназначен для создания огромной платформы, которая централизует видео со всего мира на одной ферме серверов (что ужасно дорого).

Напротив, концепция PeerTube заключается в создании сети из нескольких небольших взаимосвязанных видеохостингов.

PeerTube неповторим тем, что (насколько нам известно) это единственное сетевое приложение для размещения видео, которое сочетает в себе три преимущества:

Peer-to-peer broadcasting

• Это снижает перегрузку полосы пропускания сервера, если видео становится популярным;
• Мы становимся актером видеотрансляции;
• It's based on WebRTC, a free and open-source project for web browsers.

Веб-сайт создан Framasoft, французской некоммерческой образовательной организацией по вопросам цифровой сферы.

Они наняли разработчика Chocobozzz, который с 2018 года работает над проектами PeerTube:

• Разработка новых функций и сопровождение программного обеспечения;
• Мысли об архитектуре, дизайне и будущем PeerTube;
• Подготовка и общение с новыми стабильными выпусками (сообщения в блогах, журнал изменений и т. д.);
• Официальный сайт PeerTube разработка и поддержка;
• Список плагинов PeerTube разработка и поддержка;
• Список серверов PeerTube разработка и поддержка;
• Официальный сайт документации PeerTube (разработка и поддержка);
• Официальный сайт документации PeerTube (разработка и поддержка);
• Поддержка PeerTube и обсуждения в багтрекерах, форуме, IRC или по электронной почте;
• Проверка пул реквестов/слияние, слияния и поддержка функций, добавленных сторонними участниками (исправления ошибок, документация, рефакторинг и т. д.);
• Maintenance of several PeerTube plaftorms (peertube.cpy.re, peertube2.cpy.re, etc.).

Moreover, Chocobozzz works on internal Framasoft's projects (Framapad, Framatalk, etc.). In other words, the management of PeerTube projects is operated by only one employee, who has other responsabilities in addition to his workload.

Other Framasoft's volunteers and salaried members also contribute to the PeerTube project on various aspects (strategy, communication, development, community animation). Nevertheless, PeerTube is not developed by a startup with a team of 50 people, and a workflow full of hyper-formatted processes.

Поэтому Framasoft потратит время на постепенное улучшение программного обеспечения, в своем собственном темпе и с помощью своих нетипичных методов, которые до сих пор доказали свою эффективность.

Нет это не так.

PeerTube is a software created, developed and maintained by Framasoft, a French non-profit popular educational organization on digital issues. Framasoft has a French culture, respects French laws and is a political actor (« who participates in the life of the city-state ») of civil society.

PeerTube is part of several actions assembled by Framasoft in the Contributopia roadmap. These actions aim to propose alternative digital tools to those coming from surveillance capitalism, so that people who do not recognize themselves in such a system can create spaces of freedom.

Consequently, PeerTube development and/or management of websites associated with the PeerTube project (joinpeertube.org, instances.joinpeertube.org, search.joinpeertube.org, etc.) may not please everyone (in particular because of different ideas, ideologies of cultures).

Мы уважаем это и напоминаем, что все программное обеспечение проекта PeerTube является бесплатным и может быть установлено с собственным доменным именем.

Мы можем с уверенностью ответить: нет!

The ambition remains to be a free and decentralized alternative: the goal of an alternative is not to replace, but to propose something else, with different values, in parallel to what already exists.

Да, Framasoft владеет товарным знаком PeerTube в нескольких странах в профилактических целях.

Framasoft affirms here its intention to not use intellectual property for predatory purposes or to constrain legitimate uses of the software. However, Framasoft reserves the right to use trademark law, especially in case of damage to the image of the PeerTube project, edited by Framasoft.

Вам желательно создать свою собственную видеоплощадку на основе PeerTube для вашего проекта (со своим названием программного обеспечения, домена сайта...), чтобы не сбивать людей с толку относительно того, кто стоит за сайтом/проектом.

For more information, please refer to our Trademark Code of Conduct.

PeerTube is just the name of the software. You can install it on your server, and choose the name you want. For example, Framasoft's PeerTube platform is named FramaTube.

No it's not an octopus, it's a cuttlefish! From Latin sēpia, it's the reason why the mascot of PeerTube is called Sepia.
It has been created by David Revoy (illustrations are under CC-BY).

Sepia can also help you to search PeerTube content like videos or channels on Sepia Search!

The following web browsers are supported by PeerTube:

• Firefox 78+ on desktop
• Latest Edge version on desktop
• Latest Chrome version on desktop
• Safari 12.1+ on macOS
• Latest Chrome version on mobile
• Latest Firefox on mobile
• Safari 12.4+ on iOS

• Enjoy a player with many features
  • See the different chapters of the video in the progress bar
  • Preview the video frame while scrubbing the progress bar
  • The size of the player is automatically adjusted according to the video ratio
  • Choose subtitles, playback speed or video resolution in the player settings
  • Communicate with the streamer and other viewers using the livechat PeerTube plugin
• Станьте частью трансляции просматриваемых видео
  • Помогите веб-сайту PeerTube делиться видео и прямыми трансляциями с помощью P2P
  • Легко отключите P2P в своей учетной записи, если вы вошли в систему или в анонимных настройках
• Настройте интерфейс
  • Update your name, avatar or description in your profile
  • Установите соответствующую политику NSFW (отображать, размывать или скрывать видео NSFW)
  • Выберите тему PeerTube, чтобы изменить внешний вид интерфейса
  • Автоматически фильтруйте видео по множеству параметров (язык, категория, live/VOD и т. д.)
  • Choose your autoplay policy
• Управляйте своей библиотекой
  • Используйте встроенный плейлист Смотреть позже и легко добавляйте в него видео
  • Organize videos in public or private playlists
  • Automatically resume videos from the last time you watched them
  • Check your watch history in a dedicated page
• Подписывайтесь на каналы
  • Subscribe to local or remote channels to be notified when they publish videos
  • Display videos of your subscriptions in a dedicated page
• Share and interact with videos and playlists
  • Share the video or the playlist URL/embed with attributes (automatically start/stop at, loop enabled, muted...)
  • Download a video using a dedicated modal
  • Comment, reply and rate videos using PeerTube or an ActivityPub compatible software (Mastodon, Pleroma...)
• Поиск видео, каналов и плейлистов
  • Search local or remote videos, channels and playlists
  • Use many advanced filters (tags, category, licence...)
  • Use the video URL, playlist URL or channel handle/URL to fetch remote content

No we don't, because PeerTube is not a service but a free software. This means that anyone can download and install PeerTube to host videos on a specific domain name (this is called "hosting a PeerTube platform/website"). Framasoft has no control over who downloads PeerTube and who installs or uses it. Nor does Microsoft or Adobe have any control over who uses Word or Photoshop and for what purposes.

Framasoft only hosts and promotes two PeerTube platforms: https://framatube.org and https://peer.tube

Кроме того, Framasoft размещает и продвигает только один поисковый индекс PeerTube: https://sepiasearch.org

Administrators have full control of the content they accept and they decide whether sensitive content (violence, pornography etc.) is displayed by default or not. In its default configuration, PeerTube hides videos that contain sensitive content.

Therefore, you may find inappropriate videos on some PeerTube platforms. But it's far from being the majority of the PeerTube content. For example, in September 2021, the 900 platforms listed on our public index host only ~1% videos tagged as containing sensitive content.

See the dedicated section in the PeerTube documentation: https://docs.joinpeertube.org/use/report

The web browser generates a random string to identify the viewer during the browser session and periodically notifies the server that a user is watching the video. By default, a view is counted after 10 seconds of viewing (or 50% of the video duration if the duration is less than 10 seconds). Views are buffered, so don't panic if the view counter stays the same after you watched a video.

• Find the PeerTube website that suits you best
  • Вступайте в сообщество PeerTube, в зависимости от его темы, условий предоставления услуг или кодекса поведения
  • Talk to administrators and moderators that are real people, not robots
  • Export all your data (videos, settings, channels...) to an archive file and import it on another PeerTube platform!
• Upload and import videos
  • Upload or import videos from the web (Youtube, Dailymotion...) or from a torrent file
  • Automatically synchronize a remote channel or playlist
  • Set metadata: category, licence, language, tags, description, thumbnail...
  • Choose video privacy: public, unlisted, password protected, internal or private
  • Add subtitles
  • Add chapters
  • Easily disable comments or download
  • Upload an audio file and an image and let PeerTube take care of creating the video!
• Manage your videos
  • Let PeerTube save and store your original video file so you no longer have to keep it on your hard drive anymore (this option must be enabled by your administrator)
  • Get detailed statistics on your videos (views, watch time, unique viewers...)
  • Cut, add a watermark, an intro/outro to your videos directly from the web interface using the PeerTube studio
  • Upload a new version of the video (this option must be enabled by your administrator)
• Прямая трансляция
  • Publish live videos in PeerTube using your favorite RTMP compatible software (OBS, Restream, ffmpeg...)
  • Create permanent lives to stream multiple times inside the same live (URL doesn't change for the viewers)
  • Let PeerTube create a replay of your live sessions
  • Communicate with your viewers using the livechat PeerTube plugin
• Manage your channels
  • Create multiple channels inside your account to group your videos by topic
  • Brand your channel using a dedicated name, a banner and an avatar
  • Set a Support button for your channel to explain how to support your work
  • People can subscribe to your channel from a PeerTube website or from an ActivityPub compatible software (Mastodon, Pleroma...)
  • Create public playlists assigned to your channel to organize your content or remote videos

Быть свободным не значит быть выше закона! Каждый хостинг-провайдер PeerTube может принять решение об общих условиях использования в соответствии со своими местными законами.

For example, in France, discriminatory content is prohibited and may be reported to authorities. PeerTube allows users to report problematic videos, and administrator must then apply its moderation in accordance with its terms and conditions and the law.

There are none at the moment: PeerTube is a tool that we wanted neutral in terms of monetization.

However, the uploader can display a support button under the video. This button displays a frame in which people who upload videos can display text, images, and links freely (link to Patreon, Tipeee, Paypal, Liberapay...).

We did not go any further, as we refuse to tie our code to a particular content funding method, that might not fit all communities and deter others. It's the reason why we encourage developers to use the PeerTube plugin API to create their own monetization system.

• Free and open-source software
  • Установите PeerTube на свой сервер и создайте ваш "самодельный YouTube"
  • Official Docker support
  • Documented REST API and CLI tools
• Federation with ActivityPub
  • Enable or disable federation for your instance
  • Display videos/accounts of other instances on yours
  • Automatically follow instances from a public index
• P2P with WebRTC
  • Reduce your server bandwidth using P2P on VOD and live videos
  • Enable or disable easily P2P for your instance
  • Help (or get help) other instances using PeerTube redundancy
• Video transcoding
  • Optimize videos and generate multiple resolutions using ffmpeg
  • Enable additional video extension (.mkv, .mov, .avi...) or audio uploads
  • Generate HLS playlists or raw MP4 files
  • Customize ffmpeg transcoding profile using PeerTube plugins
  • Transcode videos by remote runners
• Прямая трансляция
  • Enable live streaming for your instance
  • Add ability for your users to publish a replay of live videos
  • Set simultaneous live streaming limits (per user/instance)
  • Enable live streaming transcoding in multiple resolutions
  • Customize ffmpeg live transcoding profile using PeerTube plugins
  • Transcode lives by remote runners
• Video imports
  • Enable video import using youtube-dl (Youtube, Dailymotion...)
  • Enable video import using webtorrent (torrent file or magnet URI)
• Инструменты модерации
  • Enable or disable signup, approve manually new users or set upload limits
  • Assign moderator/admin roles
  • Manage abuse reports on videos, accounts or comments using a dedicated dashboard
  • Automatically block videos from untrusted users awaiting a review by moderators
  • Block specific videos and specify a reason
  • Ban local users, mute accounts or instances
• Highly configurable
  • Easily set instance metadata: avatar and banner images, name, description, main categories...
  • Create your own homepage using markdown or HTML
  • Search and install PeerTube plugins or themes
  • Use external auth (LDAP, OpenID Connect...) using auth plugins
  • Choose default user settings (NSFW policy, comments/download/P2P enabled, etc)
  • Store videos and lives in the server filesystem or in object storage
  • Broadcast a message to users using a banner

The installation guide is here (only in English).

Minimum hardware requirements:

• 1 vCore
• 1.5 GB of RAM
• Enough storage for videos
• 20Mbit/s upload network speed
• Enough bandwidth to broadcast videos

Recommended hardware requirements for a big instance to handle 1,000 concurrent viewers (see our blog post about our viewers stress test):

• 4 vCore
• 4 GB of RAM
• Enough storage for videos
• 1Gbit/s upload network speed
• Enough bandwidth to broadcast videos
• Read the scalability guide if you plan to have many users or viewers

If you plan to do transcoding on the same machine as the PeerTube instance:

• 8 vCore
• 8 GB of RAM

For a more detailed guide about hardware requirements:

Except for video transcoding, a PeerTube instance is not CPU bound. Neither Nginx, PeerTube itself, PostgreSQL nor Redis require a lot of computing power. If it were only for those, one could easily get by with just one thread/vCPU.

You will hugely benefit from at least a second thread though, because of transcoding. Transcoding is very cpu intensive. It serves two purposes on a PeerTube instance: it ensures all videos can be played optimally in the web interface, and it generates different resolutions for the same video.

Transcoding can also be offloaded to other machines using remote runners.

1.5 GB of RAM should be plenty for a basic PeerTube instance, which usually takes at most 500 MB in RAM. The only reason you might want more would be if you colocate your Redis or PostgreSQL services on a non-SSD system.

There are two important angles to storage: disk space usage and sustained read speed. To make a rough estimate of your disk space usage requirements, you want to know the answer to three questions:

• What is the total size of the videos you wish to stream?
• Do you want to enable transcoding? If so, do you want to provide multiple resolutions per video? Try this out with a few videos and you will get an idea of how much extra space is required per video and estimate a multiplication factor for future space allocation.
• Which sharing mechanisms do you want to enable? Just web video, or also HLS with P2P? If you want both, this will double your storage needs.

If you want to store many videos on your PeerTube instance, you may want to store videos externally using Object Storage.

In terms of read speed, you want to make sure that you can saturate your network uplink serving PeerTube videos. This should not be a problem with SSD disks, whereas traditional HDD should be accounted for: typical sustained read rates for a well tuned system with a 7200rpm hard disk should hover around 120 MB/s or 960 Mbit/s. The latter should be enough for a typical 1 Gbit/s network uplink.

A rough estimate of a traditional server's video streaming network capacity is usually quite straightforward. You simply divide your server's available bandwidth by the average bandwidth per stream, and you have an upper bound.

Take a server for example with a 1 Gbit/s uplink for example pushing out 1080p60 streams at 5 Mbit/s per stream. That means the absolute theoretical upper capacity bound is 200 simultaneous viewers if your server's disk i/o can keep up. Expect a bit less in practice.

But what if you need to serve more users? That's where PeerTube's federation feature shines. If other PeerTube instances following yours, chances are they have decided to mirror part of your instance! The feature is called "server redundancy" and caches your most popular videos to help serve additional viewers. While viewers themselves contribute a little additional bandwidth while watching the video in their browsers (mostly during surges), mirroring servers have a much greater uplink and will help your instance with sustained higher concurrent streaming.

At the moment, you can't deploy multiple PeerTube nodes behind a load balancer.

But some pars of PeerTube can be horizontally scaled to bypass the following limits, as described in our scalability guide:

• Bandwidth: can be mitigated using PeerTube redundancy system and cache servers that serve video static files in front of your PeerTube instance
• Storage: can be mitigated using S3/Object storage
• Video transcoding: can be mitigated using remote transcoding by remote workers

If you notice performance problems or a bottleneck at your scale, don't hesitate to create an issue to discuss it.

Framasoft tries to make around 4 major releases per year. Releasing a new PeerTube version takes a lot of our time, so we cannot change this release cycle.

There is no LTS version: only the latest stable version of PeerTube is supported by Framasoft.

Если вы хотите протестировать разрабатываемую ветку PeerTube, мы предлагаем "ночные" сборки.

We try to keep compatibility with the latest minor version (2.3.1 with 2.2 for example). Unfortunately we don't have enough resources to keep compatibility with other versions.

«Это возмутительно и непоследовательно: вы выпускаете PeerTube версии x.y.z, когда он не содержит необходимых инструментов для действенного управления заявками правообладателей, или модерирования комментариев, или рекламной монетизации, или отправки предложений разработчикам. Оно не взлетит. Что вы собираетесь с этим делать?»

You're right. PeerTube is not the perfect tool, far from it. And we never promised this software would include all the features corresponding to every use cases.

Помните, что у PeerTube есть только один (почти) полностью занятый разработчик и небольшая группа очень вовлечённых добровольцев. Это не продукт, разработанный стартапом с командой, работающей полный рабочий день и значительной финансовой поддержкой.

So if you feel that PeerTube does not currently meet your needs, it's simple: don't use it right now. We remind you that we don't make money developing PeerTube, and if we obviously hope for its success, Framasoft does not depend on it to continue its activities.

Да!Since the first stable release of PeerTube in October 2018, every release added or improved moderation features:

• PeerTube 1.1 добавлены множественные действия в таблице администрирования пользователей и глушение сервера/аккаунта;
• В PeerTube 1.2 добавлена возможность расфедерировать видео из черного списка; система уведомлений теперь показывает отчеты и новых пользователей;
• В PeerTube 1.3 была добавлена возможность администраторам автоматически помещать новые видео в карантин для новых/непроверенных пользователей, пока их не рассмотрит модератор. Также было переработано управление подписчиками сервера: улучшен интерфейс, подписки могут быть запрещены;
• В PeerTube 1.4 была добавлена система плагинов и возможность для плагинов автоматически заносить видео в черный список сервера или отклонять комментарии на основе любого правила (аналогично Pleroma MRF);
• Программа установки PeerTube 2.0 теперь просит администратора ответить на вопросы, касающиеся их политики модерации и приверженности ей. Делает функцию автоматического отслеживания общедоступного списка серверов PeerTube частью ядра PeerTube, вместо ручного наполнения администраторами. Это позволяет администраторам серверов автоматически следить за серверами из «списка подписки» по своему выбору; список, который можно составлять самостоятельно, чтобы сообщества могли развиваться в своем собственном темпе;
• В PeerTube 2.1 добавлен внутренний режим конфиденциальности для видео (такие видео не будут публиковаться за пределами инстанса), а также добавлен быстрый доступ к инструментам модерации под комментариями и хукам для создания регистрационных плагинов (например, геоблокировки или captcha); некоторые сторонние плагины уже демонстрируют эту возможность. В этом выпуске также сделан акцент на описании функций модерации в интерфейсе: предупреждения о функциях, которые могут улучшить работу модерации, таких как автоподписка, и описания выпадающих списков действий.
• PeerTube 2.2 greatly improved video abuses management (search, abuses display, actions on the video or account etc), added moderation hooks and helpers in the plugins API and Framasoft developed an experimental Auto mute plugin based on public lists.
• PeerTube 2.3 improved the report modal and added predefined reasons selection. This version made it possible to delete all the comments of an account and Framasoft developed an experimental Auto block videos plugin based on public lists.
• PeerTube 2.4 added ability to report accounts and comments, a messaging system between the local reporter of an abuse and moderators, and an abuse management view for users.
• PeerTube 3.0 added a dedicated view to manage comments of the instance (list, filter, remove in bulk etc).
• ...

PeerTube developers are committed to develop and improve moderation tools to make instances always easier to manage. We welcome you to take part in discussions to help ongoing efforts in that direction or suggest new ones!

Yes, core PeerTube (PeerTube without installed plugins/themes) is compatible with GDPR:

• P2P can be disabled by default
• It doesn't send personal data to any third party if P2P is disabled
• Users can delete their account
• Users can export their data and reimport it in another instance (in PeerTube >= 6.1)
• PeerTube provides a privacy guide to help admins to fill their Terms

It probably means that we moderated your PeerTube platform after an abuse report and found out that:

• there is problematic content hosted by the platform (not only one video/account/channel or two, but severals)
• the platform doesn't seem to be properly moderated or lacks federation policy ( = lack of ToS or CoC in the about page)

Framasoft remains the sole judge of this notion of “abuse”.

• Free and open-source software
  • View, share and update PeerTube code
  • Join a community of admins, video makers and viewers
• PeerTube REST API
  • Test PeerTube REST API with the getting started guide
  • Check the REST API documentation
  • Получите помощь на форуме PeerTube
• Player embed API
  • Use the PeerTube player embed on your website
  • Control the PeerTube player embed using the embed API
  • Получите помощь на форуме PeerTube
• Plugins & Themes
  • Develop plugins and themes using the getting started guide
  • Check the complete plugin/theme documentation
  • Get help on PeerTube forum or ask new plugin/theme API in PeerTube issues

PeerTube использует ActivityPub, потому что этот протокол обмена рекомендован W3C и уже используется другими проектами, например, социальной сетью Mastodon.

IPFS is a great technology, but it still seems too young for streaming large files. The PeerTube P2P system based on well established protocols like HTTP and WebRTC, and the redundancy system are more easy for us to use and to maintain.

DTube does not seem open source, because publishing only compiled code hinders freedom of modification.

PeerTube does not impose any remuneration model. This is the choice we have made, and others (like DTube) have made other choices. So it's up to you to see what suits you.

For historical reason :)

We have a policy for contributions related to security. Please refer to our security policy and advisories.