castopod/docs/src/es/getting-started/install.md

title	sidebarDepth
Instalación	3

¿Cómo instalar Castopod?

Castopod está pensado para ser fácil de instalar. Ya sea usando un alojamiento dedicado o compartido, puedes instalarlo en la mayoría de servidores web compatibles con PHP-MySQL.

::: tip Nota

¡Hemos publicado imágenes oficiales de Docker para Castopod!

Si prefieres usar Docker, puedes saltarte esto e ir directamente a la documentación sobre docker para Castopod.

:::

Requisitos

• PHP v8.1 o superior
• MySQL versión 5.7 o superior o MariaDB versión 10.2 o superior
• Soporte HTTPS
• An ntp-synced clock to validate federation's incoming requests

PHP v8.1 o superior

Se requiere PHP versión 8.1 o superior con las siguientes extensiones instaladas:

• intl
• libcurl
• mbstring
• gd con librerias JPEG, PNG y WEBP.
• exif

Además, asegúrate de que las siguientes extensiones están habilitadas en tu PHP:

• json (habilitada por defecto - no la desactives)
• xml (habilitada por defecto - no la desactives)
• mysqlnd

Base de datos compatible con MySQL

Se recomienda usar MariaDB.

::: warning Alerta

Castopod solo funciona con base de datos compatibles con MySQL 5.7 o superior. No funcionará por ejemplo con la version previa MySQL v5.6, ya que su vida útil terminó el 5 de febrero de 2021.

:::

Necesitarás la dirección/nombre del servidor (hostname), el nombre de la base de datos, el usuario y la contraseña para completar el proceso de instalación. Si no cuentas con esta información, contacta con el administrador de tu servidor.

Privilegios

El usuario debe tener al menos estos privilegios en 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 poder generar clips de vídeo (recortes de vídeo)

Es necesario tener instalado FFmpeg versión 4.1.8 o superior si desea generar recorte de vídeos. Se debe instalar las siguientes extensiones:

• Librería FreeType 2 para gd.

(Opcional) Otras recomendaciones

• Redis para mejores rendimientos de caché.
• CDN para almacenamiento en caché de archivos estáticos y mejores rendimientos.
• Pasarela de correo para recuperación de contraseñas olvidadas.

Instrucciones de instalación

Pre-requisitos

0. Consigue un servidor web que cuente con todos los requisitos recomendados.

1. Crea una base de datos MySQL para Castopod con un usuario que tenga acceso y privilegios de modificación (para más información, ver base de datos compatible con MySQL).

2. Activa HTTPS en tu dominio web mediante un certificado SSL.

3. Descarga y descomprime en tu servidor la última versión de Castopod, si aún no lo has hecho.

   • ⚠️ Edita la configuración de tu servidor para que el "document root" sea la subcarpeta castopod/public/.

4. Añade tareas en el cron de tu servidor web para hacer funcionar varios procesos de Castopod en segundo plano (reemplaza las rutas de acuerdo a la estructura de directorios de tu servidor):

   • Esta tarea se utiliza para transmitir las actividades sociales a tus seguidores en el Fediverso:

      * * * * * /ruta/al/php /ruta/a/castopod/public/index.php scheduled-activities
   

   • Para que tus episodios sean transmitidos a los hubs abiertos que usan el nuevo protocolo WebSub (2018):

      * * * * * /ruta/al/php /castopod/public/index.php scheduled-websub-publish
   

   • Para generar Recortes de video (ver requisitos FFmpeg ):

      * * * * * /ruta/al/php /path/to/castopod/public/index.php scheduled-video-clips
   

   Estas tareas así definidas se ejecutarán cada minuto. Pero puedes definir una frecuencia más acorde a tus necesidades: cada 5, 10 minutos o más.

(recomendado) Asistente web de instalación

1. Ejecuta el script de instalación de Castopod visitando en tu navegador web esta dirección: https://tu_nombre_de_dominio.com/cp-install
2. Sigue las instrucciones en pantalla.
3. ¡Empieza a hacer podcasting!

::: info Nota

El script de instalación crea un archivo .env en la raíz de castopod. If you cannot go through the install wizard, you can create and edit the .env file manually based on the .env.example file.

:::

Configuración de Correo Electrónico/SMTP

La configuración del correo electrónico es necesaria para que algunas características funcionen correctamente (por ejemplo, recuperar su contraseña olvidada, enviando instrucciones a los suscriptores premium, …)

Puedes añadir tu configuración de correo electrónico en el archivo .env de tu instancia así:

# […]

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

Opciones de configuración de email

Nombre de la variable	Tipo	Predeterminado
fromEmail	string	undefined
fromName	string	"Castopod"
SMTPHost	string	undefined
SMTPUser	string	undefined
SMTPPass	string	undefined
SMTPPort	number	25
SMTPCrypto	["tls" or "ssl"]	"tls"

S3

By default, files are stored in the public/media folder using the filesystem.

If you prefer storing your media files on an S3 compatible storage, you may specify it in your .env:

# […]

media.fileManager="s3"
media.s3.endpoint="your_s3_host"
media.s3.key="your_s3_key"
media.s3.secret="your_s3_secret"
media.s3.region="your_s3_region"

S3 config options

Variable name	Type	Default
endpoint	string	undefined
key	string	undefined
secret	string	undefined
region	string	undefined
bucket	string	castopod
protocol	number	undefined
path_style_endpoint	boolean	false

Paquetes de la comunidad

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.

Github Repo