| Projet | PeerTube — plateforme vidéo auto-hébergée (instance locale de test) |
| Date | 2026-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 :
| Service | Image | Rôle |
|---|---|---|
peertube | chocobozzz/peertube:production (v8.2.4) | l’application — ports 9000 (HTTP) + 1935 (live RTMP) |
postgres | postgres:17-alpine | base de données |
redis | redis:8-alpine | cache / files d’attente |
postfix | mwader/postfix-relay | relais e-mails sortants (inutilisé en local) |
| — | 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 → risquepool overlapsavec les projets en marche. ✅ Blocsnetworks:supprimés préventivement (inutiles sans nginx) — jamais rencontrée. - ❌ Réelle — Phase 3 tentative 1 : j’ai supposé que
docker compose upfonctionnerait une fois les images tirées. Échec avecno space left on devicesur 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 unrmgroupé.
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 estdf -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/snap78 Go (données docker) ·/var/lib52 Go ·/var/swapfile16 Go · home ~94 Go ·/var/spool4 Go ·/var/log2,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 | État | Notes |
|---|---|---|
| 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ément | Valeur | Drapeau |
|---|---|---|
| URL de l’instance | http://peertube.localhost:9000 | local uniquement |
| Admin | root | |
| Mot de passe admin | sirekuquyoleyimetofo | auto-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 Postgres | peertube / peertube | |
| Mot de passe Postgres | 6bfbd77622f90728fcfe39c38288e448 | généré le 2026-09-19 |
PEERTUBE_SECRET | 1610777b3844adb739b899b32e88e0e4f575a4d7beb967a80e8d9508d65003aa | généré le 2026-09-19 |
| Email admin | admin@peertube.localhost | placeholder — à changer dans l’admin si besoin |
| Hostname | peertube.localhost | dé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’estpeertube.localhostaujourd’hui, donc exposition publique = instance neuve ou migration soigneuse). - Live RTMP : le port
1935est 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 --allpuissudo snap remove <name> --revision=<ancienne>.
Leçons apprises
- Vérifier
df -hd’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. - Docker sur Fedora via Snap stocke tout sous
/var/snap/dockersur la partition racine — prévoir de la marge ;docker system dfdit ce qui est récupérable. 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 utiliserdocker system prune -a --volumessur une machine avec des projets hobby arrêtés.docker image prune -aest 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érerdocker image rm <id>après revue dedocker images.- 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. - 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. - Les anciennes révisions snap +
journalctl --vacuum+dnf clean allrapportent ~2 Go ; la vraie place est dans la couche docker.