4.9 KiB
title | sidebarDepth |
---|---|
Installazione | 3 |
Come installare Castopod ?
Castopod è progettato per essere facile da installare. Che tu stia usando un hosting dedicato o condiviso, puoi installarlo sulla maggior parte dei server web compatibili con PHP-MySQL.
::: tip Nota
Abbiamo rilasciato immagini Docker ufficiali per Castopod!
Se preferisci utilizzare Docker, puoi saltare questa parte e andare direttamente alla documentazione Docker per Castopod.
:::
Prerequisiti
- PHP v8.1 solo
- Versione MySQL 5.7 o superiore o MariaDB version 10.2 o superiore
- Supporto HTTPS
- Un orologio sincronizzato con NTP per convalidare le richieste in arrivo di federtazione
PHP v8.1 solo
È richiesta la versione 8.1 di PHP, con le seguenti estensioni installate:
Inoltre, assicurati che le seguenti estensioni siano abilitate nel tuo PHP:
- json (abilitato per impostazione predefinita: non disabilitarlo)
- xml (abilitato per impostazione predefinita: non disabilitarlo)
- mysqlnd
Database compatibile con MySQL
Ti consigliamo di utilizzare MariaDB.
::: warning Attento
Castopod funziona solo con database MySQL versione 5.7 o successiva. Le versioni 5.6 (che hanno smesso di ricevere supporto il 5 febbraio 2021) o precedenti di MySQL non funzioneranno.
:::
Avrai bisogno del nome host del server, del nome del database, del nome utente e della password per completare il processo di installazione. Se non hai queste informazioni, ti preghiamo di contattare l'amministratore.
Permessi di accesso
L'utente deve avere almeno questi permessi di accesso al database per far
funzionare Castopod: CREATE
, ALTER
, DELETE
, EXECUTE
,
INDEX
,INSERT
, SELECT
, UPDATE
,REFERENCES
, CREATE VIEW
.
(Facoltativo) FFmpeg v4.1.8 o superiore per i video clip
FFmpeg versione 4.1.8 o superiore è richiesto se si desidera generare video clip. L'estensione seguente deve essere installata:
- la libreria FreeType 2 per gd.
(Facoltativo) Altri consigli
- Redis per una migliore performance nella cache.
- CDN per la cache dei file statici e una migliore performance.
- Gateway di posta per le password dimenticate.
Istruzioni di installazione
Prerequisiti
-
Prendi un server web con i prerequisiti installati
-
Crea un database MySQL per Castopod con un utente che abbia i permessi di accesso e modifica (per ulteriori informazioni, vedi Database compatibile con MySQL).
-
Abilita HTTPS sul tuo dominio con un certificato SSL.
-
Scarica e decomprimi l'ultimo pacchetto di Castopod sul server web se non l'hai già fatto.
- ⚠️ Assicurati di puntare la radice dei documenti del server web alla sotto-cartella
public/
della cartellacastopod
.
- ⚠️ Assicurati di puntare la radice dei documenti del server web alla sotto-cartella
-
Aggiungi attività cron al tuo server web per vari processi in background (sostituisci i percorsi di conseguenza):
* * * * * /percorso/all/php /percorso/di/castopod/spark tasks:run >> /dev/null 2>&1
Nota - Se non aggiungi questo task cron, le seguenti funzionalità di Castopod non funzioneranno:
- Importazione di un podcast da un feed RSS esistente
- Diffusione delle attività sociali ai tuoi seguaci nel fediverso
- Diffusione di episodi ad hub aperti usando WebSub
- Generazione di video clip - richiede FFmpeg
(Metodo consigliato) Installatore
- Esegui lo script di installazione di Castopod andando alla pagina
dell'installatore (
https://il_tuo_nome_di_dominio.com/cp-install
) nel tuo browser web preferito. - Segui le istruzioni visualizzate.
- Inizia a podcastare !
:::info Nota
Lo script di installazione crea un file .env
nella root del pacchetto. Se non
puoi utilizzare l'installatore, puoi creare ed editare manualmente il file .env
basandoti
sul file .env.example
.
:::
Configurazione email/SMTP
La configurazione dell'email è necessaria affinché alcune funzionalità funzionino correttamente (ad es. recuperare la password dimenticata, inviare istruzioni agli abbonati premium, ...)
Puoi aggiungere la configurazione dell'email nel file .env
della tua istanza come segue:
# […]
email.fromEmail="tuo_indirizzo_email"
email.SMTPHost="il_tuo_host_smtp"
email.SMTPUser="il_tuo_utente_smtp"
email.SMTPPass="la_tua_password_smtp"