Voor videogebaseerde websites voor de beste resultaten moet je een hoofdserver hebben (voor ComusThumbz), een opslagserver en 1 of meer videoconversieservers. Voor de opslag en covnersion servers kunt u gebruik maken van diensten die beschikbaar zijn, volg gewoon de links in onze admin.

Wat deze pagina dekt

Deze handleiding legt uit wat uw webserver moet hebben geïnstalleerd voordat u ComusThumbz kunt draaien. Als u ComusThumbz met succes hebt geïnstalleerd, voldoet uw server waarschijnlijk aan al deze eisen. Gebruik deze handleiding bij het instellen van een nieuwe server of probleemoplossing.

Voldoe ik aan de vereisten?

Snel controleren

De meeste hosting providers die moderne PHP websites ondersteunen kunnen ComusThumbz draaien. Je moet:

• Een Linux-server (Ubuntu, Debian, CentOS, of dergelijke)
• PHP versie 8.3 of nieuwer
• MySQL of MariaDB database
• Ten minste 2 GB RAM (4GB+ aanbevolen voor videosites)
• FFmpeg geïnstalleerd (noodzakelijk voor videoverwerking)
• IonCube

Wat ComusThumbz kan doen

Wanneer uw server aan alle eisen voldoet, hebt u toegang tot deze functies:

• Video's uploaden en beheren met automatische thumbnail generatie en meerdere kwaliteit opties
• Fotogalerijen aanmaken met beeldverwerking en bulk-uploads
• Host live webcamstreams met behulp van real-time videotechnologie
• Creator monetization inclusief tips, abonnementen en pay-per-view inhoud
• Meerdere talen ondersteuning van 25 talen van Arabisch naar Vietnamees
• Betalingsverwerking met ondersteuning voor Stripe, PayPal, CCBill en 7 andere aanbieders
• CDN-opslag om videobestanden uit te laden naar BunnyCDN, Wasabi, Backblaze en andere diensten
• Geavanceerde analyses tracking views, klikken, winst, en gebruikersgedrag
• AI-aangedreven gereedschappen om inhoud sneller te beoordelen en te organiseren

Servertype: Wat het beste werkt

Aanbevolen Hosting

Minimale server specificaties:

• 2 CPU-kernen (4+ aanbevolen)
• 2GB RAM (4GB+ aanbevolen)
• 10GB vrije schijfruimte (meer als video's lokaal worden opgeslagen)
• Ubuntu 22.04 of Debian 12

Niet aanbevolen

Softwarevereisten

Webserver

Uw server heeft ofwel Apache of Nginx om webpagina's te serveren.

Apache (meest vaak):

• Moet ondersteunen .htaccess bestanden voor schone URL's
• Versie 2.4 of nieuwer

Nginx:

• Versie 1.18 of nieuwer
• Vereist handmatige configuratie voor schone URL's

PHP-versie

Vereist: PHP 8.3 of nieuwer

ComusThumbz maakt gebruik van moderne PHP-functies die alleen werken in versie 8.3 en hoger. Oudere versies (PHP 7.x of PHP 8.0-8.2) zullen niet werken.

Uw PHP-versie controleren:

Als je server toegang hebt, voer dan uit:

php -v

Je zou zoiets moeten zien als: PHP 8.3.x

Als u een lagere versie (zoals 7.4 of 8.0) ziet, moet u PHP upgraden voordat u ComusThumbz installeert.

Database

Vereist: MySQL 5.7+ of MariaDB 10.3+

Aanbevolen: MySQL 8.0+ of MariaDB 11.4+

Uw database slaat al uw inhoud, gebruikers en instellingen op. De nieuwere versies bieden betere prestaties voor grote sites.

Videobewerkingsgereedschap (FFmpeg)

Wat is FFmpeg?
FFmpeg is een command-line tool die video's converteert naar verschillende formaten en miniaturen maakt. Het draait automatisch op de achtergrond wanneer gebruikers video's uploaden.

Controleren of FFmpeg is geïnstalleerd:

ffmpeg -version

Als u versie-informatie ziet, is FFmpeg geïnstalleerd. Als u "command not found" ziet, moet u het installeren of uw hostingprovider vragen om het te installeren.

PHP-instellingen die aangepast moeten worden

Verschillende PHP-instellingen bepalen hoe grote bestanden u kunt uploaden en hoe lang het verwerken kan duren. Deze moeten meestal worden verhoogd uit de standaard waarden.

Belangrijke instellingen

Hoe de huidige instellingen controleren

Create a file called phpinfo.php with this content:

<?php phpinfo(); ?>

Upload it to your site and visit it in a browser (example: https://yoursite.com/phpinfo.php). You'll see all PHP settings. Search for the setting names above to see current values.

PHP Functions That Must Be Enabled

Some hosting providers disable certain PHP functions for security. ComusThumbz needs these functions to work:

If these are disabled: Videos won't process, uploads will fail, and settings can't be saved.

How to enable them: Contact your hosting provider or edit php.ini if you have server access. Look for a line starting with disablefunctions = and remove any of the functions listed above.

Automatic Background Tasks (Cron Jobs)

What is a Cron Job?

A cron job is an automatic task that runs every minute in the background. It handles video processing, updates statistics, and performs other maintenance tasks.

Setting Up the Cron Job

You need to set ONE cron job that runs every minute:

The command:

     php /path/to/your/site/ct/admin/cron/sitecron.php

Replace /path/to/your/site/ with your actual installation path.

cPanel users:

Go to Advanced > Cron Jobs

1. Set timing to (every minute)
2. Paste the command above with your correct path
3. Click Add New Cron Job

HestiaCP users:

1. Log in via SSH
2. Run: crontab -e
3. Add the cron line and save

Checking if it's working:

• Videos should move from "pending" to "active" within a few minutes of upload
• Go to Admin Panel > Cron Manager to see the last run time

HTTPS / SSL Certificate

Most modern hosting providers offer free SSL certificates through Let's Encrypt.

cPanel: Go to SSL/TLS Status and click AutoSSL to get a free certificate

HestiaCP: Go to Web > [your domain] > Edit > SSL and enable Let's Encrypt

Manual setup: If you manage your own server, use Certbot:

sudo certbot --apache -d yourdomain.com

Storage Space Planning

How Much Space Do I Need?

Where Files Are Stored

After installation, these folders will hold your content:

• ct/uploads/videos/ - Uploaded video files
• ct/uploads/images/ - Images and thumbnails
• ct/cache/ - Temporary files (can be cleared)
• ct/logs/ - System logs

These folders need to be writable by the web server.

Live Streaming Requirements (Optional)

Live streaming requires Docker and LiveKit to be installed on your server.

What is Docker?
Docker is a tool that runs LiveKit (the streaming software) in an isolated container.

What is LiveKit?
LiveKit handles real-time video streaming between broadcasters and viewers.

System Requirements:

• Docker Engine 20.10 or newer
• Open ports: 7880, 7881 (TCP) and 50000-50020 (UDP)
• Separate server recommended for high-traffic streaming

Common Problems and Solutions

Videos Stay "Pending" Forever

What you see: You upload a video but it never appears on your site. In the admin panel, it shows status "pending."

Common causes:

1. Cron job not running
2. FFmpeg not installed
3. PHP functions disabled

How to fix:

1. Check if the cron job is running (see Admin Panel > Cron Manager)
2. Test FFmpeg: Run ffmpeg -version via SSH or ask your host
3. Check PHP functions: Create a test file to verify exec() works
4. Contact support if the issue persists

Can't Upload Large Files

What you see: Upload fails for videos larger than 100MB.

How to fix:

1. Increase PHP settings (uploadmaxfilesize and postmaxsize) to at least 500M
2. Restart PHP-FPM after changing settings
3. If on cPanel, use MultiPHP INI Editor

Permission Denied Errors

What you see: Errors about files or folders not being writable.

How to fix:

1. Make sure folders have correct permissions:

• ct/logs/ should be writable
• ct/uploads/ should be writable
• ct/cache/ should be writable

1. If you have SSH access, run: chmod -R 775 ct/logs ct/uploads ct/cache
2. Contact your hosting provider if you don't have SSH access

Database Connection Failed

What you see: Error message about database connection on every page.

How to fix:

1. Check that MySQL is running
2. Verify database credentials in ct/dat/config.inc.php
3. Make sure the database user has full permissions
4. Contact your hosting provider for database issues

Checking Your Server Automatically

Requirements Check Script

Save this as checkrequirements.php in your site root and visit it in your browser:

<?php
echo "<h2>ComusThumbz Requirements Check</h2>\n";
echo "<pre>\n";

// PHP Version
$phpOk = versioncompare(PHPVERSION, '8.3.0', '>=');
echo "PHP Version: " . PHPVERSION . " " . ($phpOk ? '✅ OK' : '❌ Need 8.3+') . "\n\n";

// Extensions
$extensions = ['pdo', 'pdomysql', 'gd', 'curl', 'mbstring', 'json'];
echo "Required Extensions:\n";
foreach ($extensions as $ext) {
$loaded = extensionloaded($ext);
echo " $ext: " . ($loaded ? '✅ OK' : '❌ MISSING') . "\n";
}

// Functions
$disabled = explode(',', iniget('disablefunctions'));
$required = ['exec', 'shellexec', 'mkdir', 'chmod', 'fileputcontents'];
echo "\nRequired Functions:\n";
foreach ($required as $func) {
$ok = !inarray(trim($func), arraymap('trim', $disabled));
echo " $func: " . ($ok ? '✅ OK' : '❌ DISABLED') . "\n";
}

// Settings
echo "\nPHP Settings:\n";
echo " memorylimit: " . iniget('memorylimit') . "\n";
echo " maxexecutiontime: " . iniget('maxexecutiontime') . " seconds\n";
echo " uploadmaxfilesize: " . iniget('uploadmaxfilesize') . "\n";
echo " postmaxsize: " . iniget('postmaxsize') . "\n";

// FFmpeg
echo "\nExternal Tools:\n";
$ffmpeg = @shellexec('which ffmpeg 2>/dev/null');
echo " FFmpeg: " . ($ffmpeg ? '✅ Found' : '❌ NOT FOUND') . "\n";
echo "</pre>\n";
?>

This script checks:

• PHP version
• Required extensions
• Enabled functions
• PHP settings
• FFmpeg installation

Getting Help

Where to Look First

1. Check the cron job - Most "videos not processing" issues are cron-related
2. Verify FFmpeg is installed - Run ffmpeg -version to check
3. Review PHP settings - Make sure memory and upload limits are high enough
4. Check folder permissions - Uploads folder must be writable

When to Contact Support

Contact your hosting provider if:

• You can't access PHP settings or cPanel
• FFmpeg isn't installed and you can't install it
• Database won't connect despite correct credentials
• Firewall issues are blocking connections

Contact ComusThumbz support if:

• Requirements are met but features still don't work
• You see specific error messages in the admin panel
• Configuration options aren't clear

Related Guides

Summary Checklist

Before installing ComusThumbz, verify you have:

• [ ] Linux server (VPS or dedicated, not shared hosting)
• [ ] PHP 8.3 or newer
• [ ] MySQL 5.7+ or MariaDB 10.3+
• [ ] At least 2GB RAM (4GB+ recommended)
• [ ] FFmpeg installed and working
• [ ] exec() and related PHP functions enabled
• [ ] PHP memory limit set to 512M or higher
• [ ] Upload max filesize set to 500M or higher
• [ ] Writable folders for uploads, logs, and cache
• [ ] Cron job capability (runs every minute)
• [ ] SSL certificate (free Let's Encrypt works great)
• [ ] 10GB+ free disk space

Need More Help? Check the Installation Guide next, or contact your hosting provider to verify server requirements.