Requisiti del server

TubePress funziona su un comune stack LAMP o LEMP. Non c'è nessun framework da installare, nessuna fase di build con Composer o Node e nessun loader ionCube — se il tuo hosting fa già girare WordPress, quasi sicuramente farà girare anche TubePress.

Questa pagina illustra il minimo indispensabile, la configurazione consigliata per la produzione e i pochi componenti opzionali (FFmpeg, un account TubePress) richiesti solo da funzionalità specifiche. L'installer web verifica tutto automaticamente nel passaggio Verifica di sistema.

Requisiti minimi

Questo è il minimo indispensabile. L'installer si rifiuterà di procedere finché ogni elemento obbligatorio non risulta soddisfatto.

Estensioni PHP obbligatorie

L'installazione è bloccata se queste tre estensioni non sono presenti:

Sono obbligatorie anche le sessioni PHP funzionanti e il URL rewriting lato server (Apache mod_rewrite o una regola Nginx try_files) — l'installer verifica entrambi.

Configurazione consigliata

Per un sito in produzione senza problemi:

• PHP 8.4 con OPcache — la versione su cui TubePress è sviluppato e testato, con la cache bytecode attiva per le prestazioni.
• memory_limit di 256 MB o più — margine sufficiente per importazioni massicce ed elaborazione delle immagini.
• curl, zip e GD (o Imagick) — opzionali ma consigliati: i download del catalogo e il marketplace utilizzano curl, l'installazione di temi e plugin dal pannello richiede zip, e la generazione delle miniature richiede GD o Imagick.
• HTTPS — servi il sito tramite TLS e imposta l'URL del sito all'indirizzo https.

I job pianificati vengono eseguiti automaticamente tramite il pseudo-cron integrato di TubePress, quindi nessun crontab di sistema è richiesto. I siti ad alto traffico possono comunque configurare un cron reale — vedi Cron & CLI.

Limiti di caricamento per i video

TubePress limita i caricamenti diretti a 500 MB per impostazione predefinita (modificabile in /admin/settings). I limiti PHP e del server web devono essere almeno altrettanto grandi, altrimenti i file di grandi dimensioni vengono rifiutati prima di raggiungere l'app:

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

Su Nginx aumenta anche client_max_body_size; su Apache, LimitRequestBody. Per librerie molto grandi, trascodifica e servi da uno storage remoto — vedi Transcodifica e Storage.

Server web

La root web è la directory public/, e ogni richiesta viene instradata attraverso un unico front controller, public/index.php. Mantieni config/, src/ e storage/ al di sopra della document root (si trovano un livello sopra public/) in modo che non possano mai essere serviti direttamente.

Apache

Punta la document root su public/ e consenti ai file .htaccess inclusi di fare il loro lavoro:

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

Nginx

Usa try_files per gli URL puliti, crea alias per le cartelle di temi e template, e nega i percorsi sensibili:

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;
}

Entrambi i server sono supportati in modo nativo — l'installer rileva automaticamente quale stai utilizzando.

Opzionale: FFmpeg & transcodifica

FFmpeg è necessario solo se vuoi che TubePress trascodifichi i video localmente — convertendo i caricamenti in formati compatibili con il web e generando miniature di anteprima. Se importi file già codificati o li servi da uno storage esterno o da un CDN, puoi ignorarlo completamente. Vedi Transcodifica.

Opzionale: un account TubePress

Il CMS è completo e gratuito di per sé. Un account TubePress gratuito sblocca extra pay-as-you-go — crediti AI, il catalogo di oltre 400k video, il marketplace e il supporto. Inizi con 150 crediti gratuiti e non hai mai bisogno di un account per gestire un sito completo.

Prossimi passi