Configuración de su servidor para ComusThumbz

Qué hace esta guía

Esta guía te lleva a través de la configuración de un servidor web para ejecutar ComusThumbz. Aprenderás a preparar tu entorno de alojamiento paso a paso, ya sea que estés usando un panel de control como cPanel o HestiaCP, o estableciendo un servidor nuevo tú mismo.

Al final de esta guía, su servidor estará listo para instalar y ejecutar ComusThumbz con todos los procesamientos de vídeo, manipulación de imágenes y funciones del sitio que funcionen correctamente.

[Screenshot: page-overview]

Quién es esta guía

Esta guía está escrita para los propietarios de sitios que necesitan preparar un servidor para ComusThumbz. Usted debe utilizar esta guía si:

• Acaba de comprar alojamiento o servidor y necesita configurarlo
• Estás migrando ComusThumbz a un nuevo servidor
• Su servidor actual no funciona correctamente y necesita arreglar la configuración

Usted NO necesita programación o conocimiento técnico avanzado para seguir esta guía. Proporcionaremos instrucciones claras paso a paso para cada tipo de alojamiento.

Elegir su tipo de alojamiento

ComusThumbz puede correr en varios tipos de alojamiento. Esto es lo que necesitas saber sobre cada uno:

Tipos de alojamiento comparados

Lo que su servidor necesita

Como mínimo, su alojamiento necesita:

• 1 GB de RAM (4 GB o más recomendados para sitios de vídeo)
• 1 CPU Core (4+ núcleos recomendados)
• 10 GB de espacio en disco (depende de cuánto contenido recibirás)
• Ubuntu 20.04+ o Linux similar sistema operativo

Comprender el proceso de configuración

No importa el tipo de alojamiento que elija, el proceso de configuración sigue estos mismos pasos básicos:

1. Seleccione las versiones correctas del software - Asegurarse de tener un software reciente y compatible
2. Configuración - Ajuste de límites y permisos para subidas de vídeo
3. Instalar las herramientas necesarias - Agregar software que procesa vídeos e imágenes
4. Cargar archivos ComusThumbz - Poniendo la aplicación en su servidor
5. Establecer permisos - Asegurarse de que el software pueda leer y escribir archivos
6. Planificación de tareas automatizadas - Creación de empleos de fondo que procesan vídeos
7. Corre el instalador - Completar la configuración a través de su navegador web

Caminaremos por cada paso para su tipo de alojamiento específico.

Configuración de cPanel Hosting

cPanel es el panel de control más común en alojamiento compartido y VPS. Así es como configurarlo para ComusThumbz.

Paso 1: Elija su versión de PHP

1. Inicie sesión en su cuenta de cPanel
2. Encontrar la sección llamada Software
3. Haga clic MultiPHP Manager
4. Compruebe la caja junto a su nombre de dominio
5. Desde el desplegable, seleccione PHP 8.3 (o la versión 8.x más alta disponible)
6. Haga clic Aplicar

[Screenshot: cpanel-php-version]

Paso 2: Ajuste los ajustes de PHP

1. Vuelve a la Software Sección
2. Haga clic MultiPHP INI Editor
3. Seleccione Modo de editor en la parte superior
4. Elija su dominio desde el desplegable
5. Encontrar y actualizar estos ajustes:

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

1. Haga clic Guardar en el fondo

Paso 3: Activar funciones de procesamiento de vídeo

En alojamiento compartido, es posible que no puedas hacerlo tú mismo. Póngase en contacto con su proveedor de alojamiento y pídale que active estas funciones de PHP para su cuenta:

exec

• shellexec
• passthru
• procabierto
• Popen

Diles: "Necesito estas funciones habilitadas para el procesamiento de vídeo en mi sitio".

Si tiene acceso WHM (VPS o alojamiento de revendedores):

Inicie sesión en WHMGo to Configuración de servicio ■ PHP Configuration Editor

1. Encontrar el ajuste llamado inhabilitaciónfunciones
2. Eliminar las funciones enumeradas anteriormente de esa línea
3. Haga clic Guardar y Rebuild

Paso 4: Crear su base de datos

1. En cPanel, vaya a Bases de datos ■ Bases de datos MySQL
2. Under Crear nueva base de datos, introducir un nombre como comus
3. Haga clic Crear base de datos
4. Desplazarse hacia abajo Añadir nuevo usuario
5. Crear un nombre de usuario y contraseña fuerte
6. Haga clic Crear usuario
7. Desplazarse hacia abajo Agregar usuario a la base de datos
8. Seleccione su base de datos y usuario de los desplegables
9. Haga clic Añadir
10. Check TODOS LOS PRIVILEGADOS en la siguiente pantalla
11. Haga clic Hacer cambios

Paso 5: Subir Archivos ComusThumbz

Opción A: Usando el Administrador de Archivos

1. En cPanel, vaya a Archivos ■ File Manager
2. Navigate a la públicohtml carpeta
3. Haga clic Subir en la parte superior
4. Cargue el archivo ComusThumbz zip
5. Una vez subido, haga clic derecho en el archivo zip y elija Extracto
6. Eliminar el archivo zip después de extraer

Opción B: Utilizando FTP

1. Utilice un programa FTP como FileZilla o WinSCP
2. Conectar usando estos datos:

• Host: yourdomain.com o ftp.yourdomain.com
• Nombre de usuario: su nombre de usuario cPanel
• Contraseña: contraseña de su cPanel

1. Navigate al públicoCarpeta HTML
2. Cargue todos los archivos ComusThumbz a esta carpeta

Paso 6: Configurar tareas automatizadas

ComusThumbz necesita realizar tareas de fondo cada minuto para procesar videos y mantener su sitio.

1. En cPanel, vaya a Avances ■ Cron Jobs
2. Under Add New Cron Job, establecer el tiempo para: (cada minuto)
3. En el Comando caja, ingrese:

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

Reemplazamiento username con su nombre de usuario cPanel real.

1. Haga clic Add New Cron Job

Paso 7: Completar la instalación

1. Abra su navegador web
2. Ve a: https://yourdomain.com/install/
3. Siga el asistente de instalación de 7 pasos
4. Cuando se le solicite información de la base de datos, utilice la información del Paso 4
5. Después de completar la instalación, eliminar el /install/ carpeta

Configuración de HestiaCP (VPS)

HestiaCP es un panel de control gratuito y moderno para servidores virtuales privados. Te da más control que alojamiento compartido.

Paso 1: Agregar su dominio

1. Inicia sesión en HestiaCP https://your-server-ip:8083
2. Haga clic en WEB pestaña en la parte superior
3. Haga clic en el verde Agregar dominio Web botón
4. Introduzca su nombre de dominio
5. Compruebe la caja para SSL Support
6. Compruebe la caja para Encriptemos
7. Haga clic Guardar

[Screenshot: hestiacp-add-domain]

Paso 2: Seleccione la versión PHP

1. Quédese en el WEB pestaña
2. Encuentra tu dominio en la lista
3. Haga clic en el icono de la llave junto a él
4. Desde PHP desplegable, seleccione PHP 8.3
5. Haga clic Guardar

Paso 3: Conecte vía SSH

Para los pasos restantes, necesitará conectarse a su servidor usando SSH. Esto le permite escribir comandos directamente.

En Windows:

• Descargar PuTTY o utilizar Windows Terminal
• Conéctese a la dirección IP de su servidor
• Puerto de uso 22
• Inicie sesión con su nombre de usuario y contraseña HestiaCP

En Mac/Linux:

• Terminal abierta
• Tipo: ssh username@your-server-ip
• Introduzca su contraseña cuando se le solicite

Paso 4: Activar el procesamiento de vídeo

Por defecto, HestiaCP desactiva las funciones necesarias para procesar videos. Arreglamos eso.

Escriba estos comandos uno a la vez:

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

Esto abre un editor de texto. Presione Ctrl+W para buscar, luego escriba disablefunctions y presiona Enter.

Verás una larga línea que parece:

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

Quitar estas palabras de la línea: exec,passthru,shellexec,procopen,popen

Presione Ctrl+X para salir, luego Y para guardar, luego Enter para confirmar.

Ahora reinicia PHP:

sudo systemctl restart php8.3-fpm

Paso 5: Ajuste los límites de carga

Aún en SSH, ejecute el mismo comando para editar la configuración PHP:

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

Utilice Ctrl+W para buscar y actualizar estos valores:

• Buscar memorylimit y cambiarlo a 512M
• Buscar maxexecutiontime y cambiarlo a 600
• Buscar uploadmaxfilesize y cambiarlo a 500M
• Buscar postmaxsize y cambiarlo a 500M
• Buscar maxinputvars y cambiarlo a 10000

Guardar (Ctrl+X, luego Y, luego Entrar) y reiniciar:

sudo systemctl restart php8.3-fpm

Paso 6: Instalar software de procesamiento de vídeo

ComusThumbz utiliza FFmpeg para procesar videos. Instala:

sudo apt update
sudo apt install ffmpeg

Verifique que funcionó:

ffmpeg -version

Deberías ver información de la versión. Si ve un error, FFmpeg no instaló correctamente.

Paso 7: Sube tus archivos

Volver a HestiaCP (en su navegador):

Haga clic en FILES pestaña

1. Navigate a: /home/username/web/yourdomain.com/publichtml/
2. Haga clic Subir y seleccione su archivo ComusThumbz zip
3. Después de subir, haga clic Extracto en el archivo zip
4. Eliminar el archivo zip

Paso 8: Configurar tareas automatizadas

Volver a SSH, escriba:

crontab -e

Si se le pide que elija un editor, seleccione nano (generalmente la opción 1).

Añadir esta línea en la parte inferior:

     /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

Reemplazamiento username y yourdomain.com con sus valores reales.

Guardar (Ctrl+X, luego Y, luego Entrar).

Paso 9: Instalación completa

1. En su navegador, vaya a: https://yourdomain.com/install/
2. Siga el asistente de instalación
3. Después de la finalización, eliminar el /install/ carpeta

Configuración de Plesk

Plesk es un panel de control popular para VPS y servidores dedicados.

Paso 1: Agregar su dominio

1. Entra a Plesk
2. Haga clic Sitios Web " Dominios " a la izquierda
3. Haga clic Agregar dominio
4. Introduzca su nombre de dominio y configure la configuración
5. Habilitación Apoyo SSL/TLS y seleccionar Encriptemos
6. Haga clic OK

Paso 2: Configurar PHP

1. Under Sitios Web " Dominios ", encontrar su dominio
2. Haga clic Configuración de PHP
3. Seleccione PHP 8.3 (Aplicación FPM)
4. Desplazarse y establecer estos valores:

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

1. Haga clic Aplicar o OK

Paso 3: Activar funciones de procesamiento de vídeo

Aún en PHP Settings:

1. Tranquila. Directrices adicionales Sección
2. Añadir esta línea:

disablefunctions =

(Eso es sólo disablefunctions = con nada después del signo igual)

1. Haga clic Aplicar o OK

Paso 4: Instalar FFmpeg

Conectar a su servidor a través de SSH y ejecutar:

Para servidores Ubuntu/Debian:

sudo apt install ffmpeg

Para servidores CentOS/AlmaLinux:

sudo dnf install ffmpeg

Verificar:

ffmpeg -version

Paso 5: Crear base de datos

1. En Plesk, ve a Bases de datos
2. Haga clic Añadir base de datos
3. Introduzca el nombre de la base de datos: comusthumbz
4. Crear un nombre de usuario y contraseña fuerte
5. Conceder todos los privilegios
6. Haga clic OK

Paso 6: Cargar archivos

Opción A: Plesk File Manager

1. Ve. Archivos en Plesk
2. Navigate a httpdocs/
3. Cargue sus archivos ComusThumbz

Opción B: FTP/SFTP
Utilice las credenciales mostradas en Plesk bajo Acceso FTP

Paso 7: Configurar tareas automatizadas

1. Bajo su dominio, haga clic Tareas programadas
2. Haga clic Add Task
3. Establecer horario para correr cada minuto:
4. Comando:

/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. Haga clic OK

Paso 8: Run Installer

Ve. https://yourdomain.com/install/ y completar la configuración.

Configuración de Cloudways

Cloudways proporciona alojamiento gestionado en la nube con un panel fácil de usar.

Paso 1: Inicie su aplicación

1. Inicia sesión en Cloudways
2. Haga clic Lanzamiento ■ Aplicación
3. Seleccione PHP personalizado como tipo de aplicación
4. Elija el tamaño de su servidor (2 GB RAM mínimo recomendado)
5. Select cloud provider (DigitalOcean, Vultr, AWS, etc.)
6. Introduzca nombres para su aplicación y servidor
7. Haga clic Lanzamiento

Espere unos minutos para que su servidor sea creado.

Paso 2: Configurar PHP

1. Haga clic en su aplicación
2. Ve. Ajustes de aplicaciones ■ Configuración de PHP
3. Establecer estos valores:

• Versión PHP: 8.3
• Límite de memoria: 512M
• Max Execution Time: 600
• Subir Max Filesize: 500M
• Post Max Tamaño: 500M
• Max Input Vars: 10000

1. Haga clic Guardar cambios

Paso 3: Activar el procesamiento de vídeo

Haga clic en su Servidor (no aplicación) Ajustes " Paquetes ■ AvancesEncontrar Configuración de FPM PHP

1. En la inhabilitaciónlínea de funciones, eliminar: exec, shellexec, passthru, procopen, popen
2. Guardar cambios

Paso 4: Instalar 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.