Prérequis serveur

TubePress fonctionne sur une pile LAMP ou LEMP ordinaire. Il n'y a aucun framework à installer, aucune étape de compilation Composer ou Node, et aucun chargeur ionCube — si votre hébergeur fait déjà tourner WordPress, il fera presque certainement tourner TubePress.

Cette page couvre le minimum requis, la configuration recommandée pour la production, et les quelques éléments optionnels (FFmpeg, un compte TubePress) que seules certaines fonctionnalités nécessitent. L'installateur web vérifie tout cela pour vous lors de l'étape Vérification du système.

Configuration minimale

C'est le minimum requis. L'installateur refusera de continuer tant que chaque élément obligatoire n'est pas validé.

Extensions PHP requises

L'installation est bloquée si l'une de ces trois extensions est absente :

Des sessions PHP fonctionnelles et une réécriture d'URL côté serveur (Apache mod_rewrite ou une règle Nginx try_files) sont également requises — l'installateur vérifie les deux.

Configuration recommandée

Pour un site de production fluide :

• PHP 8.4 avec OPcache — la version sur laquelle TubePress est compilé et testé, avec le cache de bytecode activé pour plus de performance.
• memory_limit de 256 Mo ou plus — marge confortable pour les importations en masse et le traitement d'images.
• curl, zip et GD (ou Imagick) — optionnels mais recommandés : les téléchargements du catalogue et la marketplace utilisent curl, l'installation de thèmes et plugins depuis le panneau nécessite zip, et la génération de miniatures nécessite GD ou Imagick.
• HTTPS — servez le site en TLS et définissez l'URL du site avec l'adresse https.

Les tâches planifiées s'exécutent automatiquement via le pseudo-cron intégré de TubePress, donc aucun crontab système n'est requis. Les sites à fort trafic peuvent toutefois configurer un vrai cron — voir Cron & CLI.

Limites d'envoi pour les vidéos

TubePress limite les envois directs à 500 Mo par défaut (réglable dans /admin/settings). Vos limites PHP et serveur web doivent être au moins aussi grandes, sinon les gros fichiers sont refusés avant d'atteindre l'application :

; php.ini - allow large video uploads
upload_max_filesize = 512M
post_max_size       = 512M
memory_limit        = 256M
max_execution_time  = 300

Sur Nginx, augmentez également client_max_body_size ; sur Apache, LimitRequestBody. Pour les très grandes bibliothèques, transcodez et servez depuis un stockage distant — voir Transcoding et Storage.

Serveur web

La racine web est le répertoire public/, et chaque requête est acheminée via un contrôleur frontal unique, public/index.php. Gardez config/, src/ et storage/ au-dessus de la racine du document (ils se trouvent un niveau au-dessus de public/) afin qu'ils ne puissent jamais être servis directement.

Apache

Pointez la racine du document vers public/ et laissez les fichiers .htaccess fournis faire leur travail :

DocumentRoot /var/www/tubepress/public
<Directory /var/www/tubepress/public>
    AllowOverride All
    Require all granted
</Directory>

Nginx

Utilisez try_files pour les URL propres, créez des alias pour les dossiers de thèmes et de templates, et bloquez les chemins sensibles :

server {
    root /var/www/tubepress/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.4-fpm.sock;
    }

    # Serve theme and template assets
    location /themes/    { alias /var/www/tubepress/themes/; }
    location /templates/ { alias /var/www/tubepress/templates/; }

    # Never expose application internals
    location ~ ^/(config|src|storage)/ { deny all; }

    client_max_body_size 512M;
}

Les deux serveurs sont pris en charge — l'installateur détecte automatiquement lequel vous utilisez.

Optionnel : FFmpeg & transcoding

Vous n'avez besoin de FFmpeg que si vous souhaitez que TubePress transcode les vidéos localement — en convertissant les envois dans des formats compatibles web et en générant des miniatures de prévisualisation. Si vous importez des fichiers déjà encodés ou que vous les servez depuis un stockage externe ou un CDN, vous pouvez l'ignorer complètement. Voir Transcoding.

Optionnel : un compte TubePress

Le CMS est complet et gratuit tel quel. Un compte TubePress gratuit débloque des fonctionnalités à la demande — AI crédits, le catalogue de plus de 400 000 vidéos, la marketplace et le support. Vous commencez avec 150 crédits gratuits et n'avez jamais besoin d'un compte pour faire tourner un site complet.

Étapes suivantes