Configuration de votre serveur pour ComusThumbz

Ce que fait ce guide

Ce guide vous accompagne dans la configuration d'un serveur web pour exécuter ComusThumbz. Vous apprendrez comment préparer votre environnement d'hébergement étape par étape, que vous utilisiez un panneau de contrôle comme cPanel ou HestiaCP, ou que vous installiez un nouveau serveur vous-même.

À la fin de ce guide, votre serveur sera prêt à installer et exécuter ComusThumbz avec toutes les fonctions de traitement vidéo, de traitement d'images et de site fonctionnant correctement.

[Screenshot: page-overview]

Pour qui ce guide est destiné

Ce guide est écrit pour les propriétaires de sites qui doivent préparer un serveur pour ComusThumbz. Vous devez utiliser ce guide si:

• Vous venez d'acheter un hébergement ou un serveur et devez le configurer
• Vous migrez ComusThumbz vers un nouveau serveur
• Votre serveur actuel ne fonctionne pas correctement et vous devez corriger la configuration

Vous n'avez PAS besoin de programmation ou de connaissances techniques avancées pour suivre ce guide. Nous fournirons des instructions claires, étape par étape pour chaque type d'hébergement.

Choisir votre type d'hébergement

ComusThumbz peut fonctionner sur plusieurs types d'hébergement. Voici ce que vous devez savoir sur chacun :

Types d'hébergement comparés

Ce dont votre serveur a besoin

Au minimum, votre hébergement nécessite:

• 1 Go de RAM (4 Go ou plus recommandé pour les sites vidéo)
• 1 CPU Core (4+ carottes recommandées)
• Espace disque de 10 Go (dépend de la quantité de contenu que vous allez accueillir)
• Ubuntu 20.04+ ou Linux similaire système d'exploitation

Comprendre le processus de mise en place

Peu importe le type d'hébergement que vous choisissez, le processus de configuration suit les mêmes étapes de base :

1. Sélectionnez les bonnes versions du logiciel - S'assurer que vous avez des logiciels récents et compatibles
2. Configuration des paramètres - Réglage des limites et des permissions pour les téléchargements vidéo
3. Installer les outils nécessaires - Ajout de logiciels qui traitent des vidéos et des images
4. Télécharger les fichiers ComusThumbz - Mettre l'application sur votre serveur
5. Définir les permissions - S'assurer que le logiciel peut lire et écrire des fichiers
6. Planifier les tâches automatisées - Mise en place de tâches de base qui traitent des vidéos
7. Lance l'installateur - Compléter la configuration par votre navigateur web

Nous passerons par chaque étape pour votre type d'hébergement spécifique.

Configuration de l'hébergement cPanel

cPanel est le panneau de contrôle le plus commun sur l'hébergement partagé et VPS. Voici comment le configurer pour ComusThumbz.

Étape 1: Choisissez votre version PHP

1. Connectez-vous à votre compte cPanel
2. Trouver la section appelée Logiciel
3. Cliquez sur Gestionnaire MultiPHP
4. Cochez la case à côté de votre nom de domaine
5. Dans le menu déroulant, sélectionnez PHP 8.3 (ou la version 8.x la plus haute disponible)
6. Cliquez sur Appliquer

[Screenshot: cpanel-php-version]

Étape 2: Régler les paramètres PHP

1. Retourne au Logiciel rubrique
2. Cliquez sur Éditeur INI MultiPHP
3. Sélectionner Mode éditeur en haut
4. Choisissez votre domaine dans la liste déroulante
5. Trouver et mettre à jour ces paramètres :

memorylimit = 512M
maxexecutiontime = 600
uploadmaxfilesize = 500M
postmaxsize = 500M
maxinputvars = 10000

1. Cliquez sur Enregistrer en bas

Étape 3: Activer les fonctions de traitement vidéo

Sur l'hébergement partagé, vous ne pouvez peut-être pas le faire vous-même. Contactez votre hébergeur et demandez-leur d'activer ces fonctions PHP pour votre compte :

exec

• coqueexec
• passthru
• procouvert
• popen

Dites-leur : « J'ai besoin de ces fonctions activées pour le traitement vidéo sur mon site. »

Si vous avez un accès WHM (hébergement VPS ou revendeur):

Connectez-vous à WHMGo Configuration du service > Éditeur de configuration PHP

1. Trouver le paramètre appelé désactiverfonctions
2. Supprimer les fonctions énumérées ci-dessus de cette ligne
3. Cliquez sur Enregistrer et Reconstruction

Étape 4: Créer votre base de données

1. Dans cPanel, allez à Bases de données > Bases de données MySQL
2. Sous Créer une nouvelle base de données, saisissez un nom comme comus
3. Cliquez sur Créer une base de données
4. Faites défiler jusqu'à Ajouter un nouvel utilisateur
5. Créer un nom d'utilisateur et un mot de passe fort
6. Cliquez sur Créer un utilisateur
7. Faites défiler jusqu'à Ajouter un utilisateur à la base de données
8. Sélectionnez votre base de données et votre utilisateur dans les menus déroulants
9. Cliquez sur Ajouter
10. Vérification TOUS LES PRIVILÈGES sur l'écran suivant
11. Cliquez sur Faire des changements

Étape 5: Télécharger les fichiers ComusThumbz

Option A : Utilisation du gestionnaire de fichiers

1. Dans cPanel, allez à Fichiers > Gestionnaire de fichiers
2. Naviguez vers la publiquehtml dossier
3. Cliquez sur Envoi en haut
4. Télécharger votre fichier zip ComusThumbz
5. Une fois téléchargé, faites un clic droit sur le fichier zip et choisissez Extrait
6. Supprimer le fichier zip après l'extraction

Option B : Utilisation de FTP

1. Utilisez un programme FTP comme FileZilla ou WinSCP
2. Connectez-vous en utilisant ces détails:

• Hôte: votredomaine.com ou ftp.votredomaine.com
• Nom d'utilisateur : votre nom d'utilisateur cPanel
• Mot de passe : votre mot de passe cPanel

1. Naviguez vers le publicdossier html
2. Télécharger tous les fichiers ComusThumbz dans ce dossier

Étape 6 : Mettre en place des tâches automatisées

ComusThumbz doit exécuter des tâches de fond toutes les minutes pour traiter des vidéos et maintenir votre site.

1. Dans cPanel, allez à Avancé > Cron Emplois
2. Sous Ajouter un nouveau Cron Job, fixez le calendrier pour: (toutes les minutes)
3. Dans Commande case, entrez :

/usr/bin/php /home/username/publichtml/ct/admin/cron/sitecron.php >> /home/username/publichtml/ct/logs/cron/sitecron.log 2>&1

Remplacer username avec votre nom d'utilisateur cPanel.

1. Cliquez sur Ajouter un nouveau Cron Job

Étape 7: Terminez l'installation

1. Ouvrez votre navigateur web
2. Allez à : https://yourdomain.com/install/
3. Suivez l'assistant d'installation en 7 étapes
4. Pour obtenir les détails de la base de données, utilisez les renseignements de l'étape 4
5. Une fois l'installation terminée, supprimer /install/ dossier

Mise en place d'HestiaCP (VPS)

HestiaCP est un panneau de contrôle gratuit et moderne pour les serveurs privés virtuels. Il vous donne plus de contrôle que l'hébergement partagé.

Étape 1: Ajouter votre domaine

1. Connectez-vous à HestiaCP à https://your-server-ip:8083
2. Cliquez sur WEB onglet en haut
3. Cliquez sur le vert Ajouter un domaine Web bouton
4. Saisissez votre nom de domaine
5. Cochez la case pour Support SSL
6. Cochez la case pour Encryptons
7. Cliquez sur Enregistrer

[Screenshot: hestiacp-add-domaine]

Étape 2: Sélectionnez la version PHP

1. Restez sur le WEB onglet
2. Trouvez votre domaine dans la liste
3. Cliquez sur l'icône de clé à côté
4. Des PHP déroulant, sélectionnez PHP 8.3
5. Cliquez sur Enregistrer

Étape 3: Connectez-vous via SSH

Pour les étapes restantes, vous devrez vous connecter à votre serveur en utilisant SSH. Cela vous permet de taper des commandes directement.

Sous Windows :

• Télécharger PuTTY ou utiliser Windows Terminal
• Connectez-vous à l'adresse IP de votre serveur
• Utiliser le port 22
• Connectez-vous avec votre nom d'utilisateur et votre mot de passe HestiaCP

Sur Mac/Linux :

• Ouvrir le terminal
• Type: ssh username@your-server-ip
• Saisissez votre mot de passe à la demande

Étape 4: Activer le traitement vidéo

Par défaut, HestiaCP désactive les fonctions nécessaires au traitement des vidéos. Réparons ça.

Tapez ces commandes une à la fois :

sudo nano /etc/php/8.3/fpm/php.ini

Cela ouvre un éditeur de texte. Appuyez sur Ctrl+W pour rechercher, puis tapez disablefunctions et appuyez sur Entrée.

Vous verrez une longue ligne qui ressemble à:

disablefunctions = exec,passthru,shellexec,system,procopen,popen,...

Supprimer ces mots de la ligne: exec,passthru,shellexec,procopen,popen

Appuyez sur Ctrl+X pour quitter, puis sur Y pour enregistrer, puis sur Entrée pour confirmer.

Maintenant redémarrez PHP :

sudo systemctl restart php8.3-fpm

Étape 5: Régler les limites de chargement

Toujours dans SSH, exécutez la même commande pour modifier la configuration PHP :

sudo nano /etc/php/8.3/fpm/php.ini

Utilisez Ctrl+W pour rechercher et mettre à jour ces valeurs :

• Rechercher memorylimit et le changer en 512M
• Rechercher maxexecutiontime et le changer en 600
• Rechercher uploadmaxfilesize et le changer en 500M
• Rechercher postmaxsize et le changer en 500M
• Rechercher maxinputvars et le changer en 10000

Enregistrer (Ctrl+X, puis Y, puis Entrée) et redémarrer:

sudo systemctl restart php8.3-fpm

Étape 6: Installer le logiciel de traitement vidéo

ComusThumbz utilise FFmpeg pour traiter des vidéos. Installez-le & #160;:

sudo apt update
sudo apt install ffmpeg

Vérifiez que ça marche :

ffmpeg -version

Vous devriez voir les informations de version. Si vous voyez une erreur, FFmpeg n'a pas correctement installé.

Étape 7: Télécharger vos fichiers

Retour dans HestiaCP (dans votre navigateur):

Cliquez sur FICHIERS onglet

1. Naviguez vers : /home/username/web/yourdomain.com/publichtml/
2. Cliquez sur Envoi et sélectionnez votre fichier zip ComusThumbz
3. Après le téléchargement, cliquez Extrait sur le fichier zip
4. Supprimer le fichier zip

Étape 8 : Mettre en place des tâches automatisées

Retour en SSH, type:

crontab -e

Si vous voulez choisir un éditeur, sélectionnez nano (généralement l'option 1).

Ajouter cette ligne en bas :

     /usr/bin/php /home/username/web/yourdomain.com/publichtml/ct/admin/cron/sitecron.php >> /home/username/web/yourdomain.com/publichtml/ct/logs/cron/sitecron.log 2>&1

Remplacer username et yourdomain.com avec vos valeurs réelles.

Enregistrer (Ctrl+X, puis Y, puis Entrée).

Étape 9: Installation complète

1. Dans votre navigateur, allez à : https://yourdomain.com/install/
2. Suivez l'assistant d'installation
3. Après achèvement, supprimer le /install/ dossier

Configuration de Plesk

Plesk est un panneau de contrôle populaire pour les serveurs VPS et dédiés.

Étape 1: Ajouter votre domaine

1. Connectez-vous à Plesk
2. Cliquez sur Sites Web et domaines à gauche
3. Cliquez sur Ajouter un domaine
4. Saisissez votre nom de domaine et configurez les paramètres
5. Activer Assistance SSL/TLS et sélectionner Encryptons
6. Cliquez sur Très bien.

Étape 2: Configurer PHP

1. Sous Sites Web et domaines, trouvez votre domaine
2. Cliquez sur Paramètres PHP
3. Sélectionner PHP 8.3 (demande FPM)
4. Faites défiler et définissez ces valeurs :

memorylimit = 512M
maxexecutiontime = 600
uploadmaxfilesize = 500M
postmaxsize = 500M
maxinputvars = 10000

1. Cliquez sur Appliquer ou Très bien.

Étape 3: Activer les fonctions de traitement vidéo

Toujours dans les paramètres PHP :

1. Faites défiler vers Directives complémentaires rubrique
2. Ajouter cette ligne :

disablefunctions =

(C'est juste disablefunctions = avec rien après le signe égal)

1. Cliquez sur Appliquer ou Très bien.

Étape 4: Installer FFmpeg

Connectez-vous à votre serveur via SSH et lancez:

Pour les serveurs Ubuntu/Debian :

sudo apt install ffmpeg

Pour les serveurs CentOS/AlmaLinux :

sudo dnf install ffmpeg

Vérifier :

ffmpeg -version

Étape 5: Créer une base de données

1. À Plesk, allez à Bases de données
2. Cliquez sur Ajouter une base de données
3. Entrez le nom de la base de données & #160;: comusthumbz
4. Créer un nom d'utilisateur et un mot de passe fort
5. Accorder tous les privilèges
6. Cliquez sur Très bien.

Étape 6: Télécharger les fichiers

Option A : Gestionnaire de fichiers Plesk

1. Allez à Fichiers dans Plesk
2. Naviguez vers httpdocs/
3. Télécharger vos fichiers ComusThumbz

Option B: FTP/SFTP
Utilisez les identifiants indiqués dans Plesk sous Accès FTP

Étape 7 : Mettre en place des tâches automatisées

1. Sous votre domaine, cliquez Tâches programmées
2. Cliquez sur Ajouter une tâche
3. Réglez l'horaire pour exécuter chaque minute:
4. Commande :

/usr/bin/php /var/www/vhosts/yourdomain.com/httpdocs/ct/admin/cron/sitecron.php >> /var/www/vhosts/yourdomain.com/httpdocs/ct/logs/cron/sitecron.log 2>&1

1. Cliquez sur Très bien.

Étape 8: Exécuter l'installateur

Allez à https://yourdomain.com/install/ et terminer l'installation.

Configuration des voies nuageuses

Cloudways fournit un hébergement cloud géré avec un panneau facile à utiliser.

Étape 1: Lancez votre application

1. Connectez-vous à Cloudways
2. Cliquez sur Lancement > Demande
3. Sélectionner PHP personnalisé comme type de demande
4. Choisissez la taille de votre serveur (2 Go de RAM minimum recommandé)
5. Sélectionnez un fournisseur de cloud (DigitalOcean, Vultr, AWS, etc.)
6. Saisissez les noms de votre application et de votre serveur
7. Cliquez sur Lancement

Attendez quelques minutes pour que votre serveur soit créé.

Étape 2: Configurer PHP

1. Cliquez sur votre application
2. Allez à Paramètres de l' application > Paramètres PHP
3. Définir ces valeurs :

• Version PHP : 8.3
• Limite de mémoire : 512M
• Temps d'exécution max : 600
• Télécharger Max Filesize : 500M
• Taille maximale du poste : 500M
• Variantes d'entrée max : 10000

1. Cliquez sur Enregistrer les modifications

Étape 3: Activer le traitement vidéo

Cliquez sur votre Serveur (pas de demande) Paramètres et paquets > AvancéRechercher Paramètres PHP FPM

1. Dans la désactivationfonctions ligne, supprimer: exec, shellexec, passthru, procopen, popen
2. Enregistrer les modifications

Étape 4: Installer FFmpeg

1. Go to Server > Master Credentials
2. Note the SSH username and password
3. Connect via SSH using these credentials
4. Run:

sudo apt install ffmpeg -y

1. Verify:

ffmpeg -version

Step 5: Upload Files

1. In Cloudways, go to your Application
2. Note the SFTP details under Access Details
3. Use an SFTP client to upload files to the publichtml/ folder

Step 6: Set Up Automated Tasks

In Cloudways, go to your ApplicationClick Cron Job ManagementClick Add Cron Job

1. Schedule: (every minute)
2. Command:

php ~/publichtml/ct/admin/cron/sitecron.php >> ~/publichtml/ct/logs/cron/sitecron.log 2>&1

1. Click Add

Step 7: Complete Installation

Visit https://yourdomain.com/install/ to complete setup.

Running the Installation Wizard

After setting up your server, the final step is running the ComusThumbz installer. This is the same process regardless of which hosting you chose.

How to Access the Installer

Open your web browser and go to:

https://yourdomain.com/install/

Replace yourdomain.com with your actual domain.

The 7 Installation Steps

Step 1: Requirements Check

The installer automatically checks if your server is ready. You'll see a list of requirements with green checkmarks or red X marks.

Green checkmarks mean everything is fine. Red X marks mean something needs to be fixed before you can continue.

Common issues:

• Missing PHP extensions - go back and make sure you installed all required software
• Wrong PHP version - select PHP 8.3 in your control panel
• Permissions errors - contact your host for help

Click Next when all critical items are green.

Step 2: Database Setup

Enter the database information you created earlier:

Host: Usually localhost (don't change this unless your host said otherwise)

• Database Name: The name you created (like comusthumbz or usernamecomus)
• Username: Your database username
• Password: Your database password
• Table Prefix: Leave as tbl (recommended)

Click Next. The installer will create all the database tables automatically.

Step 3: Configuration

The installer automatically sets up your configuration file. You don't need to do anything here - just click Next.

Step 4: Folder Setup

The installer creates all the folders needed for uploads, logs, and temporary files. Click Next.

Step 5: Default Data

The installer adds essential default data like categories and settings. Click Next.

Step 6: Admin Password

Choose a strong password for logging in to your admin panel. You'll use this to access:

https://yourdomain.com/ct/admin/

Write down this password somewhere safe.

Click Next.

Step 7: Completion

You'll see a success message. The installer will remind you to delete the /install/ folder.

This is important: Delete the install folder right away for security.

To delete it:

• Go to your File Manager or FTP
• Find the folder called install in your main directory
• Delete it completely

Making Sure Everything Works

After installation, check these items to make sure your server is working correctly.

Test 1: Can You Access the Admin Panel?

Go to: https://yourdomain.com/ct/admin/

You should see the login page. Login with the password you created in Step 6 of installation.

If you see an error, your web server might not be configured correctly. Review the server setup steps for your hosting type.

Test 2: Are Background Tasks Running?

Wait about 5 minutes after setting up your cron job, then check if it's working.

Via cPanel/Plesk/Cloudways:
Use the File Manager to navigate to:

ct/logs/cron/sitecron.log

Open this file. You should see entries with timestamps showing the cron job is running.

If the file is empty or missing:

• Go back and check that you set up the cron job correctly
• Make sure you used the right path for your hosting type
• Wait a few more minutes and check again

Test 3: Can You Upload Videos?

1. Log in to your admin panel
2. Go to Content > Video Upload
3. Try uploading a small video file (under 50 MB for testing)
4. After upload completes, check the video status

The video should show as "Processing" or "Active" within a few minutes. If it stays "Pending" forever, your video processing isn't working - see the Troubleshooting section below.

Test 4: Is Your Site Secure?

Visit your site at: https://yourdomain.com

Look for the padlock icon in your browser's address bar. If you see "Not Secure" instead, your SSL certificate may not be installed correctly.

Troubleshooting Common Problems

Problem: Videos Stay "Pending" Forever

What you see: You upload a video, but it never finishes processing. It stays stuck at "pending" status.

How to fix it:

1. First, check if your automated tasks are running (see Test 2 above)
2. If the cron log is empty, your scheduled task isn't running - review Step 6 or 7 in your hosting setup
3. If the cron is running, check if video processing functions are enabled:

• Go back to Step 3 in your hosting setup
• Make sure exec and related functions are enabled
• Contact your host if you can't enable them yourself

1. Check if FFmpeg is installed:

• Connect via SSH
• Type: ffmpeg -version
• If you see an error, FFmpeg isn't installed - go back to the FFmpeg installation step

Problem: Upload Fails with "File Too Large"

What you see: When uploading large videos, you get an error saying the file is too large.

How to fix it:

Go back to Step 2 in your hosting setup and make sure you set these values:

• uploadmaxfilesize = 500M
• postmaxsize = 500M

Also, if you're using Nginx (you'll know if you set it up manually), you need to add this to your server configuration:

clientmaxbodysize 500M;

Problem: Can't Log In to Admin Panel

What you see: You go to https://yourdomain.com/ct/admin/ but see a 404 error or can't access it.

How to fix it:

1. Make sure you deleted the /install/ folder after installation
2. Check that you uploaded all files correctly - there should be a folder called ct with an admin folder inside it
3. Check file permissions - your web server needs to be able to read the files
4. If you set up the server manually, make sure URL rewriting is enabled (modrewrite for Apache)

Problem: "Permission Denied" Errors

What you see: Various errors mentioning "permission denied" or "cannot write to file."

How to fix it:

The web server doesn't have permission to write to certain folders. You need to fix file permissions.

For cPanel/Plesk/Cloudways users:
Contact your hosting support and tell them: "I need the web server to have write permissions on the ct/logs, ct/uploads, and ct/cache directories."

For manual server setup:
Connect via SSH and run:

cd /path/to/your/site

chmod -R 775 ct/logs ct/uploads ct/cache

Problem: Database Connection Failed

What you see: During installation, you get "Connection refused" or "Access denied."

How to fix it:

1. Double-check your database username and password - these are the most common mistakes
2. Make sure the database exists - log in to your control panel and verify you created it
3. Make sure the database user has ALL PRIVILEGES on the database
4. Try using localhost as the host (not your IP address or domain name)

Problem: Site Is Slow or Times Out

What you see: Pages take forever to load or you get timeout errors.

How to fix it:

1. Check if you set maxexecution_time = 600 in your PHP settings
2. If you're on shared hosting, you may have hit resource limits - contact your host or upgrade to VPS
3. Clear your browser cache and try again
4. Check if your server has enough RAM - video sites need at least 1 GB, but 4 GB is better

What to Do Next

Now that your server is configured and ComusThumbz is installed:

1. Secure your admin panel - Change the default admin password to something strong
2. Configure storage - Set up CDN or storage servers for your video files
3. Add content - Start uploading videos and building your site
4. Customize appearance - Adjust colors, logos, and layout to match your brand
5. Set up payments - Configure payment processors if you plan to charge for content

Related Guides

Getting Help

If you're stuck and these troubleshooting steps don't help:

1. Check the error logs in your control panel
2. Look at ct/logs/php-error.log for error messages
3. Contact your hosting provider - they can check if your server meets requirements
4. Review the step-by-step instructions for your hosting type again

You're all set! Your server is ready to run ComusThumbz. Move on to configuring your site settings and adding content.