Self-host PeerTube
v8.3.2Federated video platform with in-browser P2P streaming
docker compose up- 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
chocobozzz/peertubeWhat is PeerTube?
PeerTube is a federated video hosting platform from the French non-profit Framasoft, meant for people who want their own video site instead of a centralized giant service. Instances connect through ActivityPub, so videos, channels and comments travel across the fediverse and can be followed from tools like Mastodon. Bandwidth is shared too: viewers swap video segments with each other over WebRTC, and neighbouring instances can mirror popular videos through the redundancy system, letting a small server reach a wide audience. Uploads are transcoded with ffmpeg into several resolutions, and creators also get RTMP live streaming with replays, chapters, subtitles, playlists, a browser studio for trimming and watermarks, and detailed viewing statistics. On the admin side there is a large settings surface: signup control with manual approval and upload quotas, moderator roles, abuse reports, muting and bans, plugin and theme installation, custom Markdown or HTML homepages, optional S3-compatible object storage and remote transcoding runners. You can deploy it with the official Docker Compose stack or follow the manual production guide on any OS (systemd, OpenRC or FreeBSD service files), backed by PostgreSQL and Redis behind nginx. Native Android and iOS apps exist, plus a documented REST API and CLI tools. PeerTube is AGPL-3.0 licensed, carries no paid tier or telemetry, and needs a fixed domain name because the webserver host cannot be changed after the first start.
PeerTube alternatives
InvidiousOpen-source AGPL front-end for YouTube: watch without ads, tracking or JavaScript, with own subscriptions, playlists and a REST API; runs via Docker and PostgreSQL.CompareInvidious with PeerTube
hometubeSelf-hosted, open-source video downloader for 1800+ platforms. Strips sponsors via SponsorBlock, organizes files for Plex, Jellyfin, Emby. Single Docker container.Comparehometube with PeerTube
OwncastOpen-source, self-hosted live streaming server: RTMP ingest, built-in chat with moderation, transcoding, Fediverse federation, plugins, webhooks and an admin dashboard.CompareOwncast with PeerTube
GanymedeSelf-hosted platform for saving Twitch VODs and live streams with synchronized chat, OIDC login, and Docker Compose deployment.CompareGanymede with PeerTube
yuebingYuebing is an open-source, self-hosted video sharing platform that transcodes videos to adaptive bitrate DASH/MP4, storing all data in S3 or Backblaze B2 buckets.Compareyuebing with PeerTube
VDO.NinjaOpen-source browser-based WebRTC tool that pipes remote guests, phone cameras, and screen shares into OBS and other live-production software, with director control rooms.CompareVDO.Ninja with PeerTube
ChannelTubeSelf-hosted YouTube channel downloader using yt-dlp with scheduled syncs, format options, and Plex/Jellyfin integration.CompareChannelTube with PeerTube
loopsSelf-hosted, open-source ActivityPub platform for short vertical videos with Following and For You feeds, comments, boosts and an OAuth 2.0 API.Compareloops with PeerTube
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
Website | Join an instance | Create an instance | Chat with us | Donate
Be part of a network of multiple small federated, interoperable video hosting providers. Follow video creators and create videos. No vendor lock-in. All on a platform that is community-owned and ad-free.
Developed with ❤ by Framasoft
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.
More in Video Hosting
avideoSelf-hosted, open-source video platform for on-demand libraries and live broadcasts, with HLS delivery, an encoder, plugins, and paid monetization options.
hostingTelegram Video Hosting is a self-hosted, open-source video platform using a Telegram userbot to store and serve videos via HTTP for Discord embeds.
MediaCMSSelf-hosted, open-source video and media CMS on Django and React: transcoding, HLS streaming, RBAC, SAML login, automatic captions and a REST API.

0 comments