2022-04-14 13:11:07 +00:00
|
|
|
---
|
2022-04-22 07:56:31 +00:00
|
|
|
title: Instalación
|
2022-04-14 13:11:07 +00:00
|
|
|
sidebarDepth: 3
|
|
|
|
---
|
|
|
|
|
2022-04-22 07:56:31 +00:00
|
|
|
# ¿Cómo instalar Castopod?
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
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
|
2022-04-22 07:56:31 +00:00
|
|
|
compatibles con PHP-MySQL.
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
::: Nota informativa
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
Esta sección de la documentación te ayudará a configurar Castopod para la
|
|
|
|
producción. Si estás buscando participar en el desarrollo de Castopod, debes
|
|
|
|
pasar a la sección de contribuciones.
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
:::
|
|
|
|
|
|
|
|
## Requerimientos
|
|
|
|
|
|
|
|
- PHP v8.0 o superior
|
|
|
|
- MySQL versión 5.7 o superior o MariaDB versión 10.2 o superior
|
|
|
|
- Soporte HTTPS
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
### PHP v8.0 o superior
|
|
|
|
|
|
|
|
Se requiere PHP versión 8.0 o superior con las siguientes extensiones
|
|
|
|
instaladas:
|
2022-04-14 13:11:07 +00:00
|
|
|
|
|
|
|
- [intl](https://php.net/manual/en/intl.requirements.php)
|
|
|
|
- [libcurl](https://php.net/manual/en/curl.requirements.php)
|
|
|
|
- [mbstring](https://php.net/manual/en/mbstring.installation.php)
|
2022-07-04 13:27:21 +00:00
|
|
|
- [gd](https://www.php.net/manual/en/image.installation.php) con librerias
|
|
|
|
**JPEG**, **PNG** y **WEBP**.
|
2022-04-14 13:11:07 +00:00
|
|
|
- [exif](https://www.php.net/manual/en/exif.installation.php)
|
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
Adicionalmente, asegúrate que las siguientes extensiones están habilitadas en tu
|
|
|
|
PHP:
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
- json (habilitada por defecto - no la desactives)
|
|
|
|
- xml (habilitada por defecto - no la desactives)
|
2022-04-14 13:11:07 +00:00
|
|
|
- [mysqlnd](https://php.net/manual/en/mysqlnd.install.php)
|
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
### Base de datos compatible con MySQL
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
> Recomendamos usar [MariaDB](https://mariadb.org).
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
::: aviso Aviso
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
Castopod solo funciona con base de datos compatible con MySQL 5.7 o superior. Se
|
|
|
|
romperá con la version previa MySQL v5.6 por ejemplo, ya que su vida terminó el
|
|
|
|
5 de febrero de 2021.
|
2022-04-14 13:11:07 +00:00
|
|
|
|
|
|
|
:::
|
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
Necesitarás el nombre del anfitrión del servidor, nombre de la base de datos,
|
|
|
|
usuario y contraseña para completar el proceso de instalación. Si no los tienes,
|
|
|
|
por favor, contacta al administrador del servidor.
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
#### Privilegios
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
Los usuarios deben tener al menos estos privilegios en la base de datos para que
|
|
|
|
Castopod funcione: `CREAR`, `ALTERAR`, `BORRAR`, `EJECUTAR`, `INDICE`,
|
|
|
|
`INSERTAR`, `SELECCIONAR`, `ACTUALIZAR`.
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
### (Opcional) FFmpeg v4.1.8 o superior para clips de video
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
Se requiere [FFmpeg](https://www.ffmpeg.org/) versión 4.1.8 o superior si
|
|
|
|
quieres general clips de video. Se debe instalar las siguientes extensiones:
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
- Librería **FreeType 2** para
|
2022-04-14 13:11:07 +00:00
|
|
|
[gd](https://www.php.net/manual/en/image.installation.php).
|
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
### (Opcional) Otras recomendaciones
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
- Redis para mejores rendimientos de caché.
|
|
|
|
- CDN para almacenamiento en caché de archivos estáticos y mejores rendimientos.
|
|
|
|
- puerta de enlace de email para pérdidas de contraseña.
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
## Instrucciones de instalación
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
### Prerequisitos
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
0. Consigue un Servidor Web con [requerimientos](#requirements) instalados
|
|
|
|
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
|
|
|
|
[MySQL base de datos compatible](#mysql-compatible-database)).
|
|
|
|
2. Activa HTTPS en tu domino con un _certificado SSL_.
|
|
|
|
3. Descarga y descomprime el último [paquete Castopod](https://castopod.org/) en
|
|
|
|
el servidor de la web si aún no lo has hecho.
|
|
|
|
- ⚠️ Establece la raiz del documento del servidor web en la subcarpeta
|
|
|
|
`pública/` en la carpeta `castopod`.
|
|
|
|
4. Añade **cron tasks** en tu servidor web para varios procesos en segundo plano
|
|
|
|
(reemplaza las rutas accorde con):
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
- Para que las características sociales funcionen correctamente, esta tarea
|
|
|
|
se utiliza para transmitir las actividades sociales a tus seguidores en el
|
|
|
|
Fediverso:
|
2022-04-14 13:11:07 +00:00
|
|
|
|
|
|
|
```bash
|
2022-07-04 13:27:21 +00:00
|
|
|
* * * * * /path/to/php /path/to/castopod/public/index.php actividades programadas
|
2022-04-14 13:11:07 +00:00
|
|
|
```
|
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
- Para que tus episodios sean transmitidos en hubs abiertos sobre
|
|
|
|
publicaciones usando [WebSub](https://en.wikipedia.org/wiki/WebSub):
|
2022-04-14 13:11:07 +00:00
|
|
|
|
|
|
|
```bash
|
2022-07-04 13:27:21 +00:00
|
|
|
* * * * * /usr/local/bin/php /castopod/public/index.php publicaciones-websub-programadas
|
2022-04-14 13:11:07 +00:00
|
|
|
```
|
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
- Para crear Clips de video (ver
|
|
|
|
[requerimientos FFmpeg ](#ffmpeg-v418-or-higher-for-video-clips)):
|
2022-04-14 13:11:07 +00:00
|
|
|
|
|
|
|
```bash
|
2022-07-04 13:27:21 +00:00
|
|
|
* * * * * /path/to/php /path/to/castopod/public/index.php clips-devideo-programados
|
2022-04-14 13:11:07 +00:00
|
|
|
```
|
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
> Estas tareas se ejecutan **cada minuto**. Debes establecer la frecuencia
|
|
|
|
> dependiendo de tus necesidades: cada 5, 10 minutos o más.
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
### (recomendado) Instalar Wizard
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
1. Ejecuta el script de instalación de Castopod yendo a la página de instalación
|
|
|
|
de wizard (`https://your_domain_name.com/cp-install`) en tu navegador web
|
|
|
|
preferido.
|
|
|
|
2. Sigue las instrucciones de la pantalla.
|
2022-04-22 07:56:31 +00:00
|
|
|
3. ¡Empieza a crear podcasting!
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
::: Nota informativa
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
El script de instalación escribe un archivo `.env` en la raiz de paquete. Si no
|
|
|
|
puedes completar la instalación de wizard, puedes
|
|
|
|
[crear y actualizar el archivo `.env` manualmente](#alternative-manual-configuration).
|
2022-04-14 13:11:07 +00:00
|
|
|
|
|
|
|
:::
|
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
## Paquetes de la comunidad
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
Si no quieres molestarte en instalar Castopod manualmente, puedes usar uno de
|
|
|
|
los paquetes creados y mantenidos por la comunidad de código abierto.
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
### Instalar con YunoHost
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
[YunoHost](https://yunohost.org/) es una distribuidora basada en Debian
|
|
|
|
GNU/Linux compuesta por paquetes de software libres y de código abierto. It
|
|
|
|
manages the hardships of self-hosting for you.
|
2022-04-14 13:11:07 +00:00
|
|
|
|
|
|
|
<div class="flex flex-wrap items-center gap-4">
|
|
|
|
|
|
|
|
<a href="https://install-app.yunohost.org/?app=castopod" target="_blank" rel="noopener noreferrer">
|
2022-07-04 13:27:21 +00:00
|
|
|
<img src="https://install-app.yunohost.org/install-with-yunohost.svg" alt="Instalar Castopod con YunoHost" class="align-middle" />
|
2022-04-14 13:11:07 +00:00
|
|
|
</a>
|
|
|
|
|
|
|
|
<a href="https://github.com/YunoHost-Apps/castopod_ynh" target="_blank" rel="noopener noreferrer" class="inline-flex items-center px-4 py-[.3rem] mx-auto font-semibold text-center text-black rounded-md gap-x-1 border-2 border-solid border-[#333] hover:no-underline hover:bg-gray-100"><svg
|
|
|
|
xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="1em" height="1em"
|
|
|
|
class="text-xl"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 2A10 10 0 0 0 2 12a10 10 0 0 0 6.84 9.49c.5.09.69-.21.69-.48l-.02-1.86c-2.51.46-3.16-.61-3.36-1.18-.11-.28-.6-1.17-1.02-1.4-.35-.2-.85-.66-.02-.67.79-.01 1.35.72 1.54 1.02.9 1.52 2.34 1.1 2.91.83a2.1 2.1 0 0 1 .64-1.34c-2.22-.25-4.55-1.11-4.55-4.94A3.9 3.9 0 0 1 6.68 8.8a3.6 3.6 0 0 1 .1-2.65s.83-.27 2.75 1.02a9.28 9.28 0 0 1 2.5-.34c.85 0 1.7.12 2.5.34 1.9-1.3 2.75-1.02 2.75-1.02.54 1.37.2 2.4.1 2.65.63.7 1.02 1.58 1.02 2.68 0 3.84-2.34 4.7-4.56 4.94.36.31.67.91.67 1.85l-.01 2.75c0 .26.19.58.69.48A10.02 10.02 0 0 0 22 12 10 10 0 0 0 12 2z"/></svg>Github
|
|
|
|
Repo</a>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
### Instalar con Docker
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
Si desea utilizar Docker para instalar Castopod, ¡es posible gracias a
|
2022-04-14 13:11:07 +00:00
|
|
|
[Romain de Laage](https://mamot.fr/@rdelaage)!
|
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
<a href="https://gitlab.utc.fr/picasoft/projets/services/castopod" target="_blank" rel="noopener noreferrer" class="inline-flex items-center px-4 py-2 mx-auto font-semibold text-center text-white rounded-md shadow gap-x-1 bg-[#1282d7] hover:no-underline hover:bg-[#0f6eb5]">Instalar
|
|
|
|
con
|
2022-04-14 13:11:07 +00:00
|
|
|
Docker<svg viewBox="0 0 24 24" width="1em" height="1em" class="text-xl text-pine-200"><path fill="currentColor" d="m16.172 11-5.364-5.364 1.414-1.414L20 12l-7.778 7.778-1.414-1.414L16.172 13H4v-2z"></path></svg></a>
|
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
::: Nota de información
|
2022-04-14 13:11:07 +00:00
|
|
|
|
2022-07-04 13:27:21 +00:00
|
|
|
Dada la alta demanda de docker, planeamos mantener una imagen oficial del Docker
|
|
|
|
de Castopod directamente en el repositorio de Castopod.
|
2022-04-14 13:11:07 +00:00
|
|
|
|
|
|
|
:::
|