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

---
title: Instal·lació
sidebarDepth: 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](./docker.md) per a Castopod.

:::

## Requisits

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

### PHP v8.0 o superior

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

- [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)
- [gd](https://www.php.net/manual/en/image.installation.php) amb les llibreries
  **JPEG**, **PNG** i **WEBP**.
- [exif](https://www.php.net/manual/en/exif.installation.php)

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](https://php.net/manual/en/mysqlnd.install.php)

### Base de dades compatible amb MySQL

> Us recomanem que utilitzeu [MariaDB](https://mariadb.org).

::: 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](https://www.ffmpeg.org/) versió 4.1.8
o superior. Cal instal·lar les següents extensions:

- La llibreria **FreeType 2** per
  [gd](https://www.php.net/manual/en/image.installation.php).

### (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

0. Obteniu un servidor web amb els [requisits](#requirements) instal·lats
1. 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](#mysql-compatible-database)).
2. Activeu HTTPS al vostre domini amb un _certificat SSL_.
3. Baixeu i descomprimiu el darrer [paquet Castopod](https://castopod.org/) al
   servidor web si encara no ho heu fet.
   - ⚠️ Establiu l'arrel del document del servidor web a la subcarpeta
     `castopod/public/`.
4. 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:

   ```bash
      * * * * * /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](https://en.wikipedia.org/wiki/WebSub):

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

   - Per crear clips de vídeo (consulteu
     [requisits de FFmpeg](#ffmpeg-v418-or-higher-for-video-clips)):

   ```bash
      * * * * * /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ó

1. 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.
2. Seguiu les instruccions a la vostra pantalla.
3. Comenceu a fer podcasts!

::: info Nota

L'script d'instal·lació escriu un fitxer `.env` a l'arrel del paquet. Si no
podeu fer còrrer l'assistent web d'instal·lació, podeu
[crear i actualitzar el fitxer `.env` manualment](#alternative-manual-configuration).

:::

## Paquets de la comunitat

Si no us voleu molestar amb la instal·lació manual de Castopod, podeu utilitzar
un dels paquets creats i mantinguts per la comunitat de codi obert.

### Instal·lar amb YunoHost

[YunoHost](https://yunohost.org/) és una distribució basada en Debian GNU/Linux
formada per paquets de programari lliure i de codi obert. Gestiona les
dificultats de l'auto-allotjament per tu.

<div class="flex flex-wrap items-center gap-4">

<a href="https://install-app.yunohost.org/?app=castopod" target="_blank" rel="noopener noreferrer">
   <img src="https://install-app.yunohost.org/install-with-yunohost.svg" alt="Instal·lar Castopod amb YunoHost" class="align-middle" />
</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>Repositori
a Github</a>

</div>