selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

PeerTube logo

Self-host PeerTube

v8.3.2

Federated video platform with in-browser P2P streaming

ReleaseOpen SourceAGPL-3.0
Docker ComposeCompose file & guide
docker compose up
Updated2 weeks ago
LanguageTypescript
Setup difficultyAdvanced
MobileNative app
Stars
15 409
CPU
1 vCore
RAM
1.5 GB of RAM
Storage
Enough storage for videos
Ports
9000 (PeerTube web application HTTP listener, proxied by the webserver), 1935 (RTMP ingest for live streaming)
Requires
Ffmpeg, PostgreSQL, Redis
Docker
chocobozzz/peertube
Screenshot of the PeerTube web interface

What is PeerTube?

PeerTube alternatives

All self-hosted alternatives to Dailymotion → All self-hosted alternatives to Vimeo → All self-hosted alternatives to YouTube →

Should you self-host PeerTube?

PeerTube scores 76/100 on selfhost.directory (how scoring works) and ranks #1 of 3 in Video Hosting. It has 15 409 GitHub stars, +51 in the last 30 days.

It shipped 13 stable releases in the past year. The latest, v8.3.2, came out on 26 October 2026. New versions land roughly every 2 weeks.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Invidious (80/100, 26 018 stars). It scores higher overall, so compare the two before you pick. See PeerTube vs Invidious side by side.

Features

  • Account data export and import
  • ActivityPub Federation
  • Channel subscriptions
  • Embeddable player
  • Live Streaming
  • Moderation and abuse reports
  • Object storage backend
  • P2P streaming (WebRTC)Can be disabled per instance or per account.
  • Playlists
  • Plugins and Themes
  • Registration approval
  • Remote transcoding runners
  • REST API and CLI tools
  • Video Transcoding
  • Web video editor (Studio)

PeerTube README

How to install PeerTube

Install PeerTube with Docker Compose

Environment variables
PEERTUBE_WEBSERVER_HOSTNAME, PEERTUBE_SECRET, PEERTUBE_DB_USERNAME, PEERTUBE_DB_PASSWORD, PEERTUBE_SMTP_FROM, PEERTUBE_ADMIN_EMAIL, POSTGRES_USER, POSTGRES_PASSWORD
cd /your/peertube/directory
Get the latest Compose file
curl https://raw.githubusercontent.com/chocobozzz/PeerTube/master/support/docker/production/docker-compose.yml > docker-compose.yml
Get the latest env_file
curl https://raw.githubusercontent.com/chocobozzz/PeerTube/master/support/docker/production/.env > .env
Then tweak the .env file to change the environment variables settings
sudo nano .env
Test your setup
docker compose up

PeerTube does not support webserver host change; the domain is definitive after first start. Compose includes nginx webserver, certbot, PostgreSQL, Redis and postfix.

How to configure PeerTube

  • PEERTUBE_DB_USERNAMEDatabase username used by PeerTube, copied from POSTGRES_USER
  • PEERTUBE_DB_PASSWORDDatabase password used by PeerTube, copied from POSTGRES_PASSWORD
  • PEERTUBE_DB_HOSTNAMEpostgresDatabase host; defaults to the postgres service name in docker-compose.yml
  • PEERTUBE_WEBSERVER_HOSTNAMEDomain name of the PeerTube instance, without https:// (definitive after the first start)
  • PEERTUBE_WEBSERVER_PORT9000Webserver port, used when testing PeerTube locally

PeerTube releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

How do I report PeerTube content?

Use the reporting flow described in the dedicated section of the PeerTube documentation.

Are there any inappropriate videos on PeerTube?

Some platforms may host sensitive content, but each administrator decides what is accepted and by default PeerTube hides videos tagged as containing sensitive content.

Do you control what is uploaded on a PeerTube platform?

No, PeerTube is software rather than a service, so anyone can install it and Framasoft has no control over hosting; Framasoft only hosts its own platforms.

What are the PeerTube features for viewers?

Viewers get a feature-rich player with chapters, previews, subtitles and quality settings, plus themes, filters, playlists, watch history, channel subscriptions and search.

What is PeerTube's environmental impact?

Like any digital tool it has a negative impact, which varies with the hardware used, the energy mix, whether P2P is enabled and whether content is original.

Does PeerTube have a mobile application?

Yes, an official app is published on Google Play, F-Droid, manual APK and the iOS App Store, alongside unofficial third-party clients.

What web browsers are supported by PeerTube?

Recent desktop Firefox, Edge, Chrome and Safari, plus mobile Chrome, Firefox and Safari on iOS.

I don't like the name "PeerTube"

The name is only the software's; your instance can be branded however you like, as Framasoft does with FramaTube.

Is "PeerTube" a registered trademark?

Yes, Framasoft holds the trademark in several countries for defensive reasons and recommends projects choose their own name.

Is PeerTube's purpose to replace YouTube?

No, the stated ambition is to be a free and decentralized alternative offering something different in parallel, not a replacement.

Is PeerTube a neutral software?

No: it is made by Framasoft, which describes itself as a political actor of civil society offering alternatives to surveillance capitalism.

What are the main advantages of PeerTube?

Its code is free and auditable under a libre license, instances federate over ActivityPub, delivery is shared peer-to-peer over WebRTC, and viewers, creators and admins each get rich features.

What is PeerTube?

It is a tool you install on a web server to run your own video hosting website, designed as a network of many small interconnected hosts rather than one giant platform.

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…