7.3 KiB

Raw Blame History

title	sidebarDepth
Instal·lació	3

Com instal·lar Castopod?

Castopod va ser pensat per ser fàcil d'instal·lar. Ja sigui utilitzant un allotjament dedicat o un compartit, podeu instal·lar-lo a la majoria de servidors web compatibles amb PHP-MySQL.

::: tip Nota

Hem publicat imatges oficials de Docker per a Castopod!

Si preferiu utilitzar Docker, podeu ometre això i anar directament a la documentació de Docker per a Castopod.

:::

Requisits

PHP v8.1 o superior
MySQL versió 5.7 o superior o MariaDB versió 10.2 o superior
Support d'HTTPS

PHP v8.1 o superior

Es requereix PHP versió 8.1 o superior, amb les extensions següents instal·lades:

intl
libcurl
mbstring
gd amb les llibreries JPEG, PNG i WEBP.
exif

A més, assegureu-vos que les extensions següents estiguin habilitades al vostre PHP:

json (activat per defecte; no el desactiveu)
xml (activat per defecte; no el desactiveu)
mysqlnd

Base de dades compatible amb MySQL

Us recomanem que utilitzeu MariaDB.

::: warning Avís

Castopod només funciona amb bases de dades compatibles amb MySQL 5.7 o superior. No funcionarà amb l'anterior MySQL v5.6, per exemple, ja que el seu final de vida va ser el 5 de febrer de 2021.

:::

Necessitareu el nom d'amfitrió del servidor (hostname), el nom de la base de dades, el nom d'usuari i la contrasenya per completar el procés d'instal·lació. Si no els teniu, poseu-vos en contacte amb l'administrador del vostre servidor.

Privilegis

User must have at least these privileges on the database for Castopod to work: CREATE, ALTER, DELETE, EXECUTE, INDEX, INSERT, SELECT, UPDATE, REFERENCES, CREATE VIEW.

(Opcional) FFmpeg v4.1.8 o superior per fer videoclips

Si voleu generar videoclips, cal FFmpeg versió 4.1.8 o superior. Cal instal·lar les següents extensions:

La llibreria FreeType 2 per gd.

(Opcional) Altres recomanacions

Redis per a un millor rendiment de la memòria cau.
CDN per a la memòria cau de fitxers estàtics i millors rendiments.
Passarel·la de correu electrònic per a contrasenyes perdudes.

Instruccions d'instal·lació

Pre-requisits

Obteniu un servidor web amb els requisits instal·lats
Creeu una base de dades MySQL per a Castopod amb un usuari amb privilegis d'accés i modificació (per a més informació, vegeu base de dades compatible MySQL).
Activeu HTTPS al vostre domini amb un certificat SSL.
Baixeu i descomprimiu el darrer paquet Castopod al servidor web si encara no ho heu fet.
- ⚠️ Establiu l'arrel del document del servidor web a la subcarpeta castopod/public/.
Afegiu tasques cron al vostre servidor web per a diversos processos en segon pla (substituïu les rutes d'acord a la vostra configuració de fitxers):
- Perquè les funcions socials funcionin correctament, aquesta tasca s'utilitza per transmetre activitats socials als vostres seguidors al Fediverse:
```
   * * * * * /ruta/al/php /ruta/al/castopod/public/index.php scheduled-activities
```
- Per transmetre els vostres episodis en hubs oberts després de la publicació mitjançant WebSub:
```
   * * * * * /ruta/al/php /rutal/al/castopod/public/index.php scheduled-websub-publish
```
- Per crear clips de vídeo (consulteu requisits de FFmpeg):
```
   * * * * * /ruta/al/php /ruta/al/castopod/public/index.php scheduled-video-clips
```
Aquestes tasques s'executen cada minut. Podeu configurar la freqüència segons les vostres necessitats: cada 5, 10 minuts o més.

(recomanat) Assistent d'instal·lació

Executeu l'script d'instal·lació de Castopod anant a la pàgina web de l'assistent d'instal·lació (https://exemple.com/cp-install) al vostre navegador web preferit.
Seguiu les instruccions a la vostra pantalla.
Comenceu a fer podcasts!

::: info Nota

L'script d'instal·lació escriu un fitxer .env a l'arrel del paquet. If you cannot go through the install wizard, you can create and edit the .env file manually based on the .env.example file.

:::

Email/SMTP setup

Email configuration is required for some features to work properly (eg. retrieving your forgotten password, sending instructions to premium subscribers, …)

You may add your email configuration in your instance's .env like so:

# […]

email.fromEmail="your_email_address"
email.SMTPHost="your_smtp_host"
email.SMTPUser="your_smtp_user"
email.SMTPPass="your_smtp_password"

Email config options

Variable name	Type	Default
`fromEmail`	string	`undefined`
`fromName`	string	`"Castopod"`
`SMTPHost`	string	`undefined`
`SMTPUser`	string	`undefined`
`SMTPPass`	string	`undefined`
`SMTPPort`	number	`25`
`SMTPCrypto`	[`"tls"` or `"ssl"`]	`"tls"`

Paquets de la comunitat

If you don't want to bother with installing Castopod manually, you may use one of the packages created and maintained by the open-source community.

Install with YunoHost

YunoHost is a distribution based on Debian GNU/Linux made up of free and open-source software packages. It manages the hardships of self-hosting for you.

Repositori a Github

7.3 KiB Raw Blame History