Skip to content


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.



  • Allow users to upload a new version of their video: PeerTube >= 6.0 check the box to allow the user to replace the video file in the Update Video page

VOD transcoding

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

Web Video transcoding or HLS transcoding

We have two different ways to stream the video in the PeerTube player:

  • injecting a Web compatible video file in the <video> HTML tag
  • using HLS with P2P.

At the beginning of PeerTube, we only supported Web Video (previously known as "WebTorrent") streaming. Due to several limitations of the Web Video system, we had to add HLS with P2P support. Unfortunately, we can't use the same video file for the two methods: we need to transcode 2 different versions of the file (a fragmented mp4 for HLS, and a raw mp4 for Web Videos).

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

We recommend you to enable HLS (and disable Web Videos if you don't want to store 2 different versions of the same video resolution) because video playback in PeerTube web client is better:

  • Support P2P (using WebRTC) to exchange parts of the video with other users watching the same video to save server bandwidth
  • Support video redundancy by other PeerTube instances
  • The player can adapt video resolution automatically
  • Video resolution change is smoother


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.

You can also disable Always transcode original resolution option if you want to limit the maximum resolution available on your PeerTube instance.

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.