Skip to content
On this page


Admins can configure their instance directly in the web interface using in Administration -> Configuration.

All the fields from this web interface will override your production.yaml configuration keys.

VOD transcoding

Enabling transcoding ensures that your users will have a video playback that works. It's highly recommended to enable this.

WebTorrent transcoding or HLS transcoding

We have two different ways to stream the video in the PeerTube player: using WebTorrent or HLS with P2P.

At the beginning of PeerTube, we only supported WebTorrent streaming. Due to several limitations of the library leading to many bugs, we had to add HLS (with P2P) support. Unfortunately, we can't use the same video file for WebTorrent and HLS: we need to transcode 2 different versions of the file (a fragmented mp4 for HLS, and a raw mp4 for WebTorrent).

So if you enable WebTorrent and HLS, the storage will be multiplied by 2.

We recommend you to enable HLS (and disable WebTorrent if you don't want to store 2 different versions of the same video resolution) because video playback is really better:

  • There is a buffer system so your web browser won't download the entire video (better bandwidth management)
  • We don't have to store video chunks in the web browser IndexedDB (so the video is not stored on the watcher disk, which was a little bit hacky/dirty)
  • Video resolution change is smoother (because we don't have to change the source of the <video> tag)
  • Start-up of videos is faster (especially long videos)
  • We use a widely used HLS library (hls.js) and a clean P2P WebRTC loader (p2p-media-loader) resulting in less bugs and an easier support

The main drawback is that this HLS with P2P player is not compatible with WebTorrent, so you won't be able to help the swarm using your BitTorrent client. This is a disadvantage that we accept, because we realized that BitTorrent client that helped to seed PeerTube files were not really used. Moreover, the PeerTube redundancy system can be another way to help the origin instance to seed the video.


PeerTube can transcode the uploaded video in multiple resolutions. It allows to users that does not have a high speed Internet connection to watch the video in low quality. Keep in mind that a transcoding job takes a lot of CPU, requires time and create an additional video file stored on your disk storage.

Type of files users can upload

If you enable transcoding, you can also allow additional files formats like .mkv, .avi and/or allow audio file uploads (PeerTube will create a video from them).

Live streaming

You can enable live streaming on your instance in Administration > Configuration > Live Streaming. In this section, you can choose to:

  • Allow your users to automatically save a replay of their live. Enabling VOD transcoding is required to enable this setting
  • Limit parallel lives per account/on your instance
  • Set a max duration for lives
  • Enable live transcoding. This setting is different than VOD transcoding, because PeerTube will transcode the live in real time. It means that if your instance is streaming 10 lives, PeerTube will run 10 FFmpeg processes (high CPU/RAM usage). So we recommend you to make some tests to see how many parallel lives your instance can handle before increasing limits/enabling transcoding resolutions

Bear in mind that enabling live streaming will make your server listen on port 1935/TCP (and 1936/TCP if RTMPS is enabled), which is required for incoming RTMP by your streamers. The listening port can be changed in the PeerTube configuration file.

You can enable global search, to use an external index ( This way, you give the ability to your users to get results from instances that may not be federated with yours.

To enable global search, your need to specify the Search index URL of the remote search index. Framasoft provides a search index (indexing videos from This index is not moderated, so we strongly recommend that you create your own moderated index.

Users can use a video URI or channel URI/handle search to fetch a specific remote video/channel, that may not be federated with your instance. Since this feature adds ability to your users to escape from your federation policy, you can disable it using Allow users to do remote URI/handle search or Allow anonymous to do remote URI/handle search checkboxes.