5.4 KiB
title | sidebarDepth |
---|---|
Instalación | 3 |
¿Cómo instalar Castopod?
Castopod ha sido diseñado para ser fácil de instalar. Ya sea que estés utilizando un alojamiento dedicado o compartido, puedes instalarlo en la mayoría de los servidores web compatibles con PHP-MySQL.
::: tip Nota
¡Hemos publicado imágenes oficiales de Docker para Castopod!
Si prefieres utilizar Docker, puedes omitir esta parte e ir directamente a la documentación de Docker para Castopod.
:::
Requisitos previos
- PHP v8.1 solamente
- Versión de MySQL 5.7 o superior o versión de MariaDB 10.2 o superior
- Soporte de HTTPS
- Un reloj sincronizado con NTP para validar las solicitudes entrantes de federación
PHP v8.1 solamente
Se requiere la versión 8.1 de PHP, con las siguientes extensiones instaladas:
Además, asegúrate de que las siguientes extensiones estén activadas en tu PHP:
- json (activado por defecto - no lo desactives)
- xml (activado por defecto - no lo desactives)
- mysqlnd
Base de datos compatible con MySQL
Recomendamos utilizar MariaDB.
::: warning Advertencia
Castopod solo funciona con bases de datos MySQL 5.7 o versiones más recientes. Las versiones 5.6 (cuyo soporte finalizó el 5 de febrero de 2021) o anteriores de MySQL no funcionarán.
:::
Necesitarás el nombre de host del servidor, el nombre de la base de datos, el nombre de usuario y la contraseña para completar el proceso de instalación. Si no tienes esta información, contacta a tu administrador.
Permisos de acceso
El usuario debe tener al menos los siguientes permisos de acceso a la base de datos para que Castopod funcione: CREATE
, ALTER
, DELETE
, EXECUTE
, INDEX
,INSERT
, SELECT
, UPDATE
,REFERENCES
, CREATE VIEW
.
(Opcional) FFmpeg v4.1.8 o superior para clips de vídeo
Se requiere FFmpeg versión 4.1.8 o superior si deseas generar Clips de Vídeo. Deben estar instaladas las siguientes extensiones:
- Biblioteca FreeType 2 para gd.
(Opcional) Otras recomendaciones
- Redis para un mejor rendimiento del caché.
- CDN para la caché de archivos estáticos y un mejor rendimiento.
- Pasarela de correo electrónico para contraseñas olvidadas.
Instrucciones de instalación
Requisitos previos
-
Obtén un servidor web con los requisitos previos instalados.
-
Crea una base de datos MySQL para Castopod con un usuario que tenga los permisos de acceso y modificación (para obtener más información, consulta Base de datos compatible con MySQL).
-
Activa HTTPS en tu dominio con un certificado SSL.
-
Descarga y descomprime el último paquete de Castopod en el servidor web si aún no lo has hecho.
- ⚠️ Haz que la raíz del documento del servidor web apunte a la subcarpeta
public/
de la carpetacastopod
.
- ⚠️ Haz que la raíz del documento del servidor web apunte a la subcarpeta
-
Agrega tareas programadas a tu servidor web para varios procesos en segundo plano (reemplaza las rutas según corresponda):
* * * * * /ruta/hacia/php /ruta/hacia/castopod/spark tasks:run >> /dev/null 2>&1
Nota - Si no añades esta tarea programada, las siguientes características de Castopod no funcionarán:
- Importar un podcast desde un feed RSS existente
- Transmitir actividades sociales a tus seguidores en el federado
- Transmitir episodios a hubs abiertos utilizando WebSub
- Generación de clips de vídeo - requiere FFmpeg
(Método recomendado) Asistente de instalación
- Ejecuta el script de instalación de Castopod visitando la página de Asistente de Instalación (
https://tu_nombre_de_dominio.com/cp-install
) en tu navegador web favorito. - Sigue las instrucciones que se muestran.
- ¡Comienza a hacer podcast!
:::info Nota
El script de instalación crea un archivo .env
en la raíz del paquete. Si no puedes usar el asistente de instalación, puedes crear y editar manualmente el archivo .env
basándote en el archivo .env.example
.
:::
Configuración de correo electrónico/SMTP
La configuración de correo electrónico es necesaria para que algunas características funcionen correctamente (por ejemplo, recuperar tu contraseña olvidada, enviar instrucciones a suscriptores premium, ...)
Puedes agregar la configuración de correo electrónico en el archivo .env
de tu instancia de la siguiente manera:
# […]
email.fromEmail="tu_dirección_de_correo_electrónico"
email.SMTPHost="tu_host_smtp"
email.SMTPUser="tu_usuario_smtp"
email.SMTPPass="tu_contraseña_smtp"
Opciones de configuración de correo electrónico
Nombre de variable | Tipo | Valor por defecto |
---|---|---|
fromEmail |
string | undefined |
fromName |
string | "Castopod" |
**`SMTPHost |