Aller au contenu
TubePress — gratuit, auto-hébergé & activement maintenu
Prise en main

Installation

Téléversez les fichiers et terminez l’installateur web en 6 étapes en cinq minutes environ.

TubePress s'installe comme n'importe quelle application PHP classique : uploadez les fichiers, pointez un navigateur sur votre domaine et suivez un court assistant web. Aucune ligne de commande, aucune étape de compilation.

Comptez environ cinq minutes. Avant de commencer, vérifiez que votre serveur respecte les exigences et ayez à portée de main les informations de votre base de données.

Télécharger TubePress

Récupérez la dernière version depuis la page de téléchargement. Il s'agit d'un simple et léger ZIP contenant la totalité du code source PHP modifiable — aucune clé de licence et pas d'ionCube.

Envoyer sur votre serveur

Extrayez le ZIP et envoyez son contenu sur votre serveur via FTP/SFTP ou le gestionnaire de fichiers de votre hébergeur. La seule règle importante : votre racine web doit pointer vers le répertoire public/, et non vers la racine du projet. Tout le reste — config/, src/, storage/, themes/, plugins/ — se trouve un niveau au-dessus de la racine du document et n'est jamais servi directement.

Hébergement mutualisé. Si vous ne pouvez pas déplacer la racine web, pointez votre domaine (ou un sous-domaine) vers le dossier …/public dans votre panneau de contrôle.

Lancer l'installateur web

Accédez à votre domaine dans un navigateur. Puisqu'il n'existe pas encore de marqueur config/installed.php, TubePress vous redirige directement vers l'assistant de configuration. Il comporte six étapes :

  1. Bienvenue. Un court écran d'introduction — cliquez pour commencer.
  2. Vérification système. Vérifie votre version PHP, les extensions et les dossiers accessibles en écriture. Lorsque toutes les vérifications requises sont validées, l'assistant avance automatiquement ; en cas d'échec, chaque élément se développe pour indiquer comment le corriger.
  3. Base de données. Saisissez l'hôte, le nom, l'utilisateur et le mot de passe de votre base de données. TubePress se connecte, crée la base de données si possible (ou utilise une existante en hébergement mutualisé), exécute toutes les migrations SQL et écrit config/database.php. Le champ hôte accepte également host:port ou un chemin de socket.
  4. Administrateur. Créez votre compte administrateur — un nom d'utilisateur (3–50 caractères), une adresse e-mail valide et un mot de passe d'au moins 8 caractères.
  5. Paramètres. Nommez votre site (la description est optionnelle). L'URL du site est détectée automatiquement et le nombre de vidéos par page est de 24 par défaut — les deux étant modifiables ultérieurement.
  6. Terminé. TubePress initialise les pages par défaut, les paramètres et les valeurs SEO par défaut, écrit le marqueur d'installation et vous donne le lien vers votre nouveau panneau d'administration.
Aucun SQL à importer. L'étape Base de données exécute toutes les migrations numérotées de TubePress pour vous — il n'y a pas de fichier .sql à charger manuellement.

Permissions de fichiers

L'utilisateur du serveur web (souvent www-data) doit être propriétaire et pouvoir écrire dans trois emplacements : config/ (pour sauvegarder vos paramètres), storage/ (logs, fichiers temporaires et sauvegardes) et public/uploads/ (vos médias). La vérification système signale ceux qui ne sont pas accessibles en écriture.

# Give the web-server user ownership
chown -R www-data:www-data config storage public/uploads

# Directories 755, files 644
find config storage public/uploads -type d -exec chmod 755 {} \;
find config storage public/uploads -type f -exec chmod 644 {} \;

Seuls ces trois chemins doivent être accessibles en écriture par le serveur ; le reste de l'arborescence peut rester en lecture seule.

Apache vs Nginx

Les deux sont entièrement pris en charge et détectés automatiquement lors de l'installation.

  • Apache — définissez AllowOverride All pour que les fichiers .htaccess fournis puissent gérer les URLs propres et bloquer l'accès aux dossiers sensibles. À la fin, TubePress crée des liens symboliques public/themes et public/templates afin que les ressources du thème soient accessibles.
  • Nginx — ajoutez la règle standard try_files … /index.php?$query_string, aliasez /themes/ et /templates/ vers les dossiers du projet, et configurez deny pour les chemins config/, src/ et storage/. Les extraits complets se trouvent dans les Exigences.

Développement local (localhost)

TubePress fonctionne sur une installation localhost en HTTP simple sans configuration particulière — l'installateur, les sessions et la connexion fonctionnent tous sans HTTPS. Deux options faciles :

  • Un serveur web local (le plus proche de la production) — pointez Apache ou Nginx vers le dossier public/, exactement comme ci-dessus.
  • Le serveur intégré de PHP (zéro configuration) — depuis la racine du projet, exécutez la commande ci-dessous, puis ouvrez http://localhost:8000.
php -S localhost:8000 -t public public/router.php

Le fichier router.php fourni vous offre des URLs propres, et le contrôleur frontal sert les ressources du thème et de l'administration directement — ainsi le style fonctionne immédiatement, même sans configurer les alias de ressources.

HTTPS est optionnel en local. TubePress ne marque son cookie de session Secure que lorsqu'il détecte réellement HTTPS ; ainsi, la connexion via http://localhost simple fonctionne normalement. Ajoutez TLS lorsque vous passez en production.

Après l'installation

Connectez-vous à /admin avec le compte que vous venez de créer et commencez à configurer votre site. Le guide des premières étapes vous accompagne à travers l'identité du site, la personnalisation, vos premières vidéos et une liste de contrôle avant mise en ligne. Il est également recommandé de renforcer rapidement la connexion à l'administration — voir Sécurité.

L'installateur se verrouille lui-même. Une fois que vous atteignez l'étape Terminé, TubePress écrit config/installed.php et toutes les routes /install sont définitivement désactivées. Ne supprimez pas ce marqueur sur un site en production — c'est ce qui empêche l'assistant de configuration de se rouvrir.

Étapes suivantes

Toujours bloqué ?

Ouvrez un ticket depuis votre tableau de bord et notre équipe vous assistera.

Essayer la démo en direct → Télécharger TubePress →