🧩 1 – PeerTube, c’est quoi ?
PeerTube est une plateforme de diffusion vidéo libre, décentralisée et open source, pensée comme une alternative à YouTube, Vimeo ou Dailymotion. Créée et maintenue par l’association française Framasoft, elle repose sur des technologies fédératrices comme ActivityPub et WebTorrent. Cela permet à chaque instance d’être indépendante tout en pouvant interagir avec d’autres, à la manière du Fediverse.
🎥 1a – Utilisation
Concrètement, PeerTube permet à quiconque de créer sa propre plateforme vidéo. Que vous soyez une association, une collectivité, un créateur de contenu ou simplement un passionné souhaitant partager ses vidéos dans un cadre éthique, PeerTube est une solution solide.
Vous pouvez :
- Uploader vos vidéos,
- Gérer des playlists,
- Organiser vos chaînes,
- Activer la fédération avec d’autres instances,
- Diffuser en direct grâce à la fonctionnalité de live streaming.
🚀 1b – Performance
PeerTube est conçu pour être léger et scalable. Il utilise :
- PostgreSQL comme base de données,
- Redis pour la gestion de file d’attente et de cache,
- WebTorrent pour alléger la bande passante grâce à la distribution P2P (chaque spectateur devient aussi “seeder”).
La performance est donc étroitement liée à votre matériel, votre réseau et à l’usage P2P activé. Pour une utilisation personnelle ou communautaire, un simple serveur peut suffire ; pour des usages intensifs, une bonne configuration réseau et stockage rapide sont recommandés.
👥 1c – Pour qui et pourquoi faire ?
- Les créateurs de contenu qui souhaitent héberger eux-mêmes leurs vidéos.
- Les collectifs ou associations cherchant une alternative aux plateformes centralisées.
- Les écoles et universités pour diffuser des cours.
- Les entreprises pour de la communication interne ou des formations.
C’est aussi un excellent moyen de protéger la vie privée des utilisateurs tout en conservant un contrôle total sur son contenu.
🛠️ 2 – Installation via Docker (Container Manager)
Installer PeerTube avec Docker est l’une des méthodes les plus simples et les plus propres. Elle permet une gestion simplifiée des services, une mise à jour facile, et une isolation propre des composants du système.
📦 2a – Prérequis d’installation
Avant de lancer quoi que ce soit, il faut préparer le terrain.
🗂️ Création des dossiers nécessaires
Créez un dossier de travail pour votre instance PeerTube. Par exemple :
mkdir -p /volume1/docker/peertube/{config,storage,postgres,uploads}
Cela va créer la structure suivante :
/volume1/docker/peertube/
├── config → Fichiers de configuration PeerTube
├── storage → Stockage des vidéos et vignettes
├── uploads → dossier temporaire pour les Upload
└── postgres → Données de la base PostgreSQL
🔐 Droits d’accès
PeerTube tourne dans le conteneur Docker avec l’UID/GID 1000:1000. Il faut donc donner les bons droits aux dossiers :
chown -R 1000:1000 /volume1/docker/peertube
chmod -R 755 /volume1/docker/peertube
Sur un NAS Synology, ces commandes peuvent être lancées via SSH avec les droits administrateur.
🧱 2b – Génération du docker-compose.yml
Voici un exemple de fichier docker-compose.yml prêt à l’emploi pour faire tourner PeerTube via Docker sur une instance auto-hébergée (NAS, serveur perso, etc.) : (pour votre Synology fichier a mettre dans /volume1/docker/peertube)
version: "3.7"
services:
postgres:
image: postgres:15
container_name: peertube_postgres
environment:
POSTGRES_DB: peertube
POSTGRES_USER: peertube
POSTGRES_PASSWORD: peertube_password
volumes:
- ./postgres:/var/lib/postgresql/data
restart: unless-stopped
redis:
image: redis:7
container_name: peertube_redis
restart: unless-stopped
peertube:
image: chocobozzz/peertube:production-bullseye
container_name: peertube
depends_on:
- postgres
- redis
ports:
- "9000:9000" # Accès à http://tonNAS:9000
environment:
PEERTUBE_WEBSERVER_HOSTNAME: VOTREIPDUNAS
PEERTUBE_WEBSERVER_PORT: 9000
PEERTUBE_DB_HOSTNAME: postgres
PEERTUBE_DB_USERNAME: peertube
PEERTUBE_DB_PASSWORD: peertube_password
PEERTUBE_REDIS_HOSTNAME: redis
PEERTUBE_SIGNUP_ENABLED: false
PEERTUBE_WEBSERVER_HTTPS: false
PEERTUBE_TRUST_PROXY: 1
PEERTUBE_INSTANCE_NAME: GameoverBlogTV
PEERTUBE_SMTP_ENABLED: false
PEERTUBE_SECRET: "23471ab4578fecf5e252189eabef85a2b37852b4eec4163507e0036b7f15927f"
volumes:
- ./data:/data
- ./config:/config
- ./uploads:/uploads
restart: unless-stopped
🔧 Lancer l’installation
Dans Container Manager

Fait ensuite « Suivant » jusqu’à installation des conteneurs.
🔐 2c – Première connexion avec réinitialisation du mot de passe admin
Une fois les conteneurs Docker lancés avec succès, vous pouvez accéder à votre instance PeerTube via l’adresse suivante :
http://<IP_de_votre_serveur>:9000
Mais à ce stade, vous ne pourrez pas encore vous connecter car aucun mot de passe n’a été défini pour l’utilisateur root. Voici la procédure pour le créer ou le réinitialiser :
✅ Réinitialiser le mot de passe de l’utilisateur root
- Rendez-vous dans le dossier où se trouve votre fichier docker-compose.yml
- Exécutez la commande suivante :
docker compose exec -u peertube peertube npm run reset-password -- -u root
- Un prompt vous demandera d’entrer un nouveau mot de passe pour l’utilisateur root. Choisissez un mot de passe sécurisé.
- Vous pouvez maintenant vous connecter avec :
- Utilisateur : root
- Mot de passe : celui que vous venez de définir
💡 Astuce : Vous pouvez également créer un autre utilisateur administrateur depuis l’interface ou via la base de données si besoin.
✅ Si tout s’est bien passé, vous avez maintenant une instance PeerTube fonctionnelle et sécurisée !
🎬 3 – Conclusion
PeerTube est une alternative sérieuse et libre aux plateformes de partage de vidéos traditionnelles. En s’appuyant sur le pouvoir du fédéré, cette solution permet de reprendre le contrôle sur ses contenus tout en favorisant l’interopérabilité avec d’autres instances (via le réseau Fediverse).
Que ce soit pour un usage personnel, communautaire, associatif ou même professionnel, PeerTube s’adapte à de nombreux contextes.
Avec ce guide, vous avez maintenant toutes les bases pour :
✅ Comprendre l’intérêt et le fonctionnement de PeerTube
✅ Déployer votre propre instance grâce à Docker en toute simplicité
✅ Sécuriser et administrer votre espace vidéo