PeerTube

ProjetPeerTube — plateforme vidéo auto-hébergée (instance locale de test)
Date2026-09-19 (TERMINÉ)
Statut✅ EN FONCTION — HTTP 200 OK sur http://peertube.localhost:9000, admin root connecté

1. Mise en place & contraintes

  • Machine : Fedora 44 (hôte), Docker 29.8.0 (paquet Snap, pas Docker Desktop), Docker Compose v5.0.0-desktop.1. Plusieurs autres stacks coexistent (Rocket.Chat, Supabase, Misskey, freeCodeCamp, model-runner).
  • Contrainte : le bac à sable ne peut pas exécuter Docker, ouvrir des ports hôte ni écrire les fichiers système → j’ai exécuté les commandes sur le terminal de l’hôte et j’ai collé la sortie pour interprétation. Exception : le bac à sable peut écrire dans le dossier personnel de l’hôte, donc les fichiers ~/peertube/ ont été préparés depuis le bac à sable.
  • Objectif atteint : PeerTube v8.2.4 accessible sur http://peertube.localhost:9000, en local uniquement (pas de domaine, pas de HTTPS).

2. Architecture choisie

Compose officiel de production (support/docker/production/), adapté pour le test local selon le guide Docker officiel :

ServiceImageRôle
peertubechocobozzz/peertube:production (v8.2.4)l’application — ports 9000 (HTTP) + 1935 (live RTMP)
postgrespostgres:17-alpinebase de données
redisredis:8-alpinecache / files d’attente
postfixmwader/postfix-relayrelais e-mails sortants (inutilisé en local)
webserver / certbot / webserver-reloader—supprimés (pas de nginx, pas de TLS en local)

Adaptations locales dans ~/peertube/docker-compose.yml : nginx/certbot/reloader supprimés ; 9000:9000 activé ; volume nommé assets retiré ; IP statiques + sous-réseau 172.18.0.0/16 retirés (utiles seulement pour nginx, et risque de conflit avec les nombreux projets compose en marche).

3. Étapes chronologiques

Phase 1 — Vérifications hôte ✅

docker --version → 29.8.0 · docker compose version → v5.0.0-desktop.1 · docker ps OK · openssl rand -hex 32 → PEERTUBE_SECRET.

Phase 2 — Dossier de travail & config ✅

Préparé depuis le bac à sable : ~/peertube/docker-compose.yml (adapté local) + ~/peertube/.env (hostname peertube.localhost, port 9000, HTTPS off, secrets générés). Sur l’hôte : .env relu, 127.0.0.1 peertube.localhost ajouté à /etc/hosts.

Phase 3 — Démarrage — 1ère tentative ❌ (disque plein)

docker compose up -d   # images tirées OK (4/4)
# Error response from daemon: … overlay2/…-init/merged/etc/hostname: no space left on device

Cause : partition racine pleine à 99 % (287 G / 291 G utilisés) — voir section 5.

Phase 4 — Nettoyage disque ✅ (≈ 110 Go récupérés)

sudo journalctl --vacuum-time=10d          # +1,5 Go
sudo dnf clean all                          # +205 Mo
docker volume prune -f                      # +76,47 Go (4 volumes orphelins, aucune référence conteneur)
docker image rm <liste sélective>           # +~25 Go (anciennes versions supabase, node, mongo:8.2.5,
                                            # clickhouse, dockurr, jitsi, traefik, adminer, mongo-express,
                                            # redisinsight, coredns, postgrest, athenaos/rdp (10 Go !),
                                            # caelestia-desktop, webkul/bagisto — confirmés par moi)

⚠️ Les images Appwrite + openruntimes (~12,5 Go) ont été conservées à ma demande — Appwrite est toujours sur ma liste « à lancer ».

Phase 5 — Démarrage & vérification ✅ (2026-09-19 10:40)

cd ~/peertube && docker compose up -d      # [+] up 4/4
docker compose ps                          # 4/4 Up (postfix healthy)
docker compose logs peertube | grep -A1 root
# Username: root  /  User password: sirekuquyoleyimetofo
curl -I http://peertube.localhost:9000     # HTTP/1.1 200 OK  (x-powered-by: PeerTube)

4. Erreurs

  • ⚠️ Anticipée : le compose officiel fixe 172.18.0.0/16 + IP statique → risque pool overlaps avec les projets en marche. ✅ Blocs networks: supprimés préventivement (inutiles sans nginx) — jamais rencontrée.
  • ❌ Réelle — Phase 3 tentative 1 : j’ai supposé que docker compose up fonctionnerait une fois les images tirées. Échec avec no space left on device sur la couche du conteneur. ✅ Correctif : nettoyage disque (Phase 4), puis relance.
  • ❌ Mineure : j’ai ré-exécuté un bloc de nettoyage déjà partiellement traité par le terminal → erreurs bénignes No such image: … pour des images déjà supprimées. Sans gravité ; leçon : vérifier les IDs avant un rm groupé.

5. Constats (cause racine)

  • Docker installé en Snap (/var/snap/docker/common/var-lib-docker) : les données des conteneurs sont sur la partition racine, pas sur un système de fichiers séparé. Le bon indicateur est df -h /.
  • État disque avant nettoyage : /dev/nvme0n1p5 291G — 287G utilisés, 3,5G libres (99 %). Docker à lui seul ~141 Go (56 Go images + 79 Go volumes + 7 Go cache), dont ~119 Go récupérables.
  • Carte du stockage : /var/snap 78 Go (données docker) · /var/lib 52 Go · /var/swapfile 16 Go · home ~94 Go · /var/spool 4 Go · /var/log 2,9 Go.
  • docker volume prune (sans -a) ne supprime que les volumes avec zéro référence conteneur (en marche ou arrêtés) → la façon sûre de récupérer 76 Go sans toucher aux volumes des conteneurs arrêtés (Nextcloud/Misskey/freeCodeCamp).

6. Tableau de statut

ComposantÉtatNotes
CLI Docker / Compose✅29.8.0 / v5.0.0-desktop.1
Fichiers ~/peertube/✅préparés depuis le bac à sable
/etc/hosts✅127.0.0.1 peertube.localhost
peertube✅Up, :9000 + :1935
postgres / redis / postfix✅Up (postfix healthy)
UI web✅http://peertube.localhost:9000 → HTTP 200
Admin root✅mot de passe dans les logs (voir identifiants)
Disque✅31 Go libres après nettoyage (90 % utilisés)

7. Tableau des identifiants / config

ÉlémentValeurDrapeau
URL de l’instancehttp://peertube.localhost:9000local uniquement
Adminroot
Mot de passe adminsirekuquyoleyimetofoauto-généré le 2026-09-19 — à changer : docker compose exec -u peertube peertube npm run reset-password -- -u root ou dans l’app (Réglages → Admin)
Utilisateur / BDD Postgrespeertube / peertube
Mot de passe Postgres6bfbd77622f90728fcfe39c38288e448généré le 2026-09-19
PEERTUBE_SECRET1610777b3844adb739b899b32e88e0e4f575a4d7beb967a80e8d9508d65003aagénéré le 2026-09-19
Email adminadmin@peertube.localhostplaceholder — à changer dans l’admin si besoin
Hostnamepeertube.localhostdéfinitif — PeerTube ne supporte pas le changement de hostname

8. Blocs de config réutilisables

.env complet + diff compose : PeerTube - Config + Details.md (appliqué en direct dans ~/peertube/).

9. Dernière capture de vérification (2026-09-19 10:40)

$ docker compose ps
NAME                  IMAGE                             STATUS                    PORTS
peertube-peertube-1   chocobozzz/peertube:production    Up 32 seconds             0.0.0.0:1935->1935/tcp, 0.0.0.0:9000->9000/tcp, 1936/tcp
peertube-postfix-1    mwader/postfix-relay              Up 33 seconds (healthy)   25/tcp
peertube-postgres-1   postgres:17-alpine                Up 33 seconds             5432/tcp
peertube-redis-1      redis:8-alpine                    Up 33 seconds             6379/tcp

$ curl -I http://peertube.localhost:9000
HTTP/1.1 200 OK
x-powered-by: PeerTube

10. Travail optionnel / futur

  • Changer le mot de passe et l’email admin, puis créer un vrai compte.
  • Exposition publique avec un vrai domaine + Let’s Encrypt (réajouter webserver/certbot ; le hostname doit être décidé avant le premier démarrage — c’est peertube.localhost aujourd’hui, donc exposition publique = instance neuve ou migration soigneuse).
  • Live RTMP : le port 1935 est déjà mappé.
  • Stockage objet S3 pour les vidéos (variables documentées dans .env).
  • Fédération : suivre d’autres instances, remote runners pour le transcodage.
  • Nettoyage des révisions snap (timeout pendant l’aventure, snapd occupé) — à relancer : snap list --all puis sudo snap remove <name> --revision=<ancienne>.

Leçons apprises

  1. Vérifier df -h d’abord. Un disque plein se manifeste par des erreurs daemon bizarres (p. ex. open …/overlay2/…/etc/hostname: no space left on device) qui n’ont rien à voir avec l’app installée.
  2. Docker sur Fedora via Snap stocke tout sous /var/snap/docker sur la partition racine — prévoir de la marge ; docker system df dit ce qui est récupérable.
  3. docker volume prune ≠ risque de perte de données — sans -a, il ne touche que les volumes sans aucune référence conteneur (les conteneurs arrêtés gardent leurs volumes). Ne jamais utiliser docker system prune -a --volumes sur une machine avec des projets hobby arrêtés.
  4. docker image prune -a est un piège pour les projets « je relancerai plus tard » — il supprime les images sans conteneur, même celles qui comptent (athenaos/rdp faisait 10 Go !). Préférer docker image rm <id> après revue de docker images.
  5. La recette locale PeerTube fonctionne comme documenté : peertube.localhost + port 9000 + HTTPS=false, nginx/certbot commentés, IP statiques retirées → 4 conteneurs, identifiants admin affichés une seule fois dans les logs.
  6. Ré-exécuter des blocs de nettoyage à l’aveugle produit des erreurs alarmantes mais inoffensives No such image — vérifier l’état (docker images/docker volume ls) avant de lancer des suppressions en lot.
  7. Les anciennes révisions snap + journalctl --vacuum + dnf clean all rapportent ~2 Go ; la vraie place est dans la couche docker.