Compare revisions

00870cef · 00870cef · 00870cef · 00870cef · 00870cef · 00870cef
--- a/docs/src/es/getting-started/auth.md
+++ b/docs/src/es/getting-started/auth.md
 ---
 title: Autenticación & Autenticación
-sidebarDepth: 3
 ---

-# Autenticación & Autenticación
-
 Castopod gestiona la autenticación y autorización usando `codeignitor/escudo`
 emparejado con reglas personalizadas. Los roles y permisos se definen en dos
 niveles:
@@ -16,24 +13,25 @@ niveles:

 ### Roles de instancia

-<!-- AUTH-INSTANCE-ROLES-LIST:START - Do not remove or modify this section -->
+{/* AUTH-INSTANCE-ROLES-LIST:START - Do not remove or modify this section */}

-| roles               | descripción                            | permisos                                                                                   |
-| ------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------ |
-| Super administrador | Tiene control completo sobre Castopod. | admin.\*, podcasts.\*, users.manage, persons.manage, pages.manage, fediverse.manage-blocks |
-| Administrador       | Gestiona el contenido de Castopod.     | podcasts.create, podcasts.import, persons.manage, pages.manage                             |
-| Podcaster           | Usuarios generales de Castopod.        | admin.access                                                                               |
+| role                | description                            | permissions                                                                                            |
+| ------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| Super administrador | Tiene control completo sobre Castopod. | admin.\*, plugins.\*, podcasts.\*, users.manage, persons.manage, pages.manage, fediverse.manage-blocks |
+| Administrador       | Administrar contenido de Castopod.     | podcasts.create, podcasts.import, persons.manage, pages.manage                                         |
+| Podcaster           | Usuarios generales de Castopod.        | admin.access                                                                                           |

-<!-- AUTH-INSTANCE-ROLES-LIST:END -->
+{/* AUTH-INSTANCE-ROLES-LIST:END */}

 ### Permisos de instancia

-<!-- AUTH-INSTANCE-PERMISSIONS-LIST:START - Do not remove or modify this section -->
+{/* AUTH-INSTANCE-PERMISSIONS-LIST:START - Do not remove or modify this section */}

-| permisos                | descripción                                                                    |
+| permission              | description                                                                    |
 | ----------------------- | ------------------------------------------------------------------------------ |
 | admin.access            | Puedes acceder al área de administración de Castopod.                          |
 | admin.settings          | Puede acceder a la configuración de Castopod.                                  |
+| plugins.manage          | Auth.instance_permissions.plugins.manage                                       |
 | users.manage            | Puede administrar usuarios de Castopod.                                        |
 | persons.manage          | Puede administrar personas.                                                    |
 | pages.manage            | Puede administrar páginas.                                                     |
@@ -42,47 +40,47 @@ niveles:
 | podcasts.import         | Puede importar podcasts.                                                       |
 | fediverse.manage-blocks | Puedes bloquear la interacción de actores/dominios del fediverso con Castopod. |

-<!-- AUTH-INSTANCE-PERMISSIONS-LIST:END -->
+{/* AUTH-INSTANCE-PERMISSIONS-LIST:END */}

 ## 2. Permisos y roles por podcast

 ### Roles por podcast

-<!-- AUTH-PODCAST-ROLES-LIST:START - Do not remove or modify this section -->
+{/* AUTH-PODCAST-ROLES-LIST:START - Do not remove or modify this section */}

-| roles         | descripción                                                       | permisos                                                                                                                                                                                                                                                                                             |
-| ------------- | ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Administrador | Tiene el control completo del podcast #{id}.                      | \*                                                                                                                                                                                                                                                                                                   |
-| Editor        | Gestiona el contenido y las publicaciones del podcast #{id}.      | view, edit, manage-import, manage-persons, manage-platforms, manage-publications, interact-as, episodes.view, episodes.create, episodes.edit, episodes.delete, episodes.manage-persons, episodes.manage-clips, episodes.manage-publications, episodes.manage-comments, episodes.manage-notifications |
-| Autor         | Gestiona el contenido del podcast #{id} pero no puede publicarlo. | view, manage-persons, episodes.view, episodes.create, episodes.edit, episodes.manage-persons, episodes.manage-clips                                                                                                                                                                                  |
-| Invitado      | Colaborador general del podcast #{id}.                            | view, episodes.view                                                                                                                                                                                                                                                                                  |
+| role          | description                                                         | permissions                                                                                                                                                                                                                                                                                 |
+| ------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Administrador | Tiene el control completo del podcast #\{id\}.                      | \*                                                                                                                                                                                                                                                                                          |
+| Editor        | Gestiona el contenido y las publicaciones del podcast #\{id\}.      | view, edit, manage-import, manage-persons, manage-platforms, manage-publications, manage-notifications, interact-as, episodes.view, episodes.create, episodes.edit, episodes.delete, episodes.manage-persons, episodes.manage-clips, episodes.manage-publications, episodes.manage-comments |
+| Autor         | Gestiona el contenido del podcast #\{id\} pero no puede publicarlo. | view, manage-persons, episodes.view, episodes.create, episodes.edit, episodes.manage-persons, episodes.manage-clips                                                                                                                                                                         |
+| Invitado      | Colaborador general del podcast #\{id\}.                            | view, episodes.view                                                                                                                                                                                                                                                                         |

-<!-- AUTH-PODCAST-ROLES-LIST:END -->
+{/* AUTH-PODCAST-ROLES-LIST:END */}

 ### Permisos por podcast

-<!-- AUTH-PODCAST-PERMISSIONS-LIST:START - Do not remove or modify this section -->
-
-| permisos                     | descripción                                                                                        |
-| ---------------------------- | -------------------------------------------------------------------------------------------------- |
-| view                         | Puede ver el panel de control y análisis del podcast #{id}.                                        |
-| edit                         | Puede editar podcast #{id}.                                                                        |
-| delete                       | Puede borrar el podcast #{id}.                                                                     |
-| manage-import                | Puede sincronizar el podcast importado #{id}.                                                      |
-| manage-persons               | Puede administrar las suscripciones del podcast #{id}.                                             |
-| manage-subscriptions         | Puede administrar las suscripciones del podcast #{id}.                                             |
-| manage-contributors          | Puede administrar colaboradores del podcast #{id}.                                                 |
-| manage-platforms             | Puede establecer/eliminar enlaces a la plataforma del podcast #{id}.                               |
-| manage-publications          | Puede publicar el podcast #{id}.                                                                   |
-| manage-notifications         | Puede ver y marcar las notificaciones como leídas para podcast #{id}.                              |
-| interact-as                  | Puede interactuar como el podcast #{id} para favoritar, compartir o responder a las publicaciones. |
-| episodes.view                | Puede ver el panel de control y analíticas del episodio #{id}.                                     |
-| episodes.create              | Puede crear episodios para el podcast #{id}.                                                       |
-| episodes.edit                | Puede editar episodios #{id}.                                                                      |
-| episodes.delete              | Puede borrar el podcast #{id}.                                                                     |
-| episodes.manage-persons      | Puede administrar las suscripciones del podcast #{id}.                                             |
-| episodes.manage-clips        | Puedes administrar video clips o sonidos del podcast #{id}.                                        |
-| episodes.manage-publications | Puede publicar el podcast #{id}.                                                                   |
-| episodes.manage-comments     | Puede crear/eliminar los comentarios de episodio del podcast #{id}.                                |
-
-<!-- AUTH-PODCAST-PERMISSIONS-LIST:END -->
+{/* AUTH-PODCAST-PERMISSIONS-LIST:START - Do not remove or modify this section */}
+
+| permission                   | description                                                                                                     |
+| ---------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| view                         | Puede ver el panel de control y analíticas del episodio #\{id\}.                                                |
+| edit                         | Puede editar el podcast #\{id\}.                                                                                |
+| delete                       | Puede borrar el podcast #\{id\}.                                                                                |
+| manage-import                | Puede sincronizar el podcast importado #\{id\}.                                                                 |
+| manage-persons               | Puede administrar las suscripciones del podcast #\{id\}.                                                        |
+| manage-subscriptions         | Puede administrar las suscripciones del podcast #\{id\}.                                                        |
+| manage-contributors          | Puede administrar colaboradores del podcast #\{id\}.                                                            |
+| manage-platforms             | Puede establecer/eliminar enlaces a la plataforma del podcast #\{id\}.                                          |
+| manage-publications          | Puede publicar el podcast #\{id\}.                                                                              |
+| manage-notifications         | Puede ver y marcar las notificaciones como leídas para podcast #\{id\}.                                         |
+| interact-as                  | Puede interactuar como el podcast #\{id\} para marcar como favarito, compartir o responder a las publicaciones. |
+| episodes.view                | Puede ver el panel de control y analíticas del episodio #\{id\}.                                                |
+| episodes.create              | Puede crear episodios para el podcast #\{id\}.                                                                  |
+| episodes.edit                | Puede editar episodios del podcast #\{id\}.                                                                     |
+| episodes.delete              | Puede borrar episodios del podcast #\{id\}.                                                                     |
+| episodes.manage-persons      | Puede administrar las personas de los episodios del podcast #\{id\}.                                            |
+| episodes.manage-clips        | Puedes administrar video clips o sonidos del podcast #\{id\}.                                                   |
+| episodes.manage-publications | Puede publicar/despublicar episodios y publicaciones del podcast #\{id\}.                                       |
+| episodes.manage-comments     | Puede crear/eliminar los comentarios de episodio del podcast #\{id\}.                                           |
+
+{/* AUTH-PODCAST-PERMISSIONS-LIST:END */}
--- a/docs/src/content/docs/es/getting-started/docker.mdx
+++ b/docs/src/content/docs/es/getting-started/docker.mdx
+---
+title: Imágenes oficiales de Docker
+---
+
+Castopod lanza 3 imágenes Docker al Docker Hub durante su proceso de
+construcción automatizada:
+
+- [**`castopod/castopod`**](https://hub.docker.com/r/castopod/castopod): una
+  imagen completa de castopod que utiliza una unidad nginx
+- [**`castopod/app`**](https://hub.docker.com/r/castopod/app): el paquete
+  completo de la aplicación con todas las dependencias de Castopod
+- [**`castopod/web-server`**](https://hub.docker.com/r/castopod/web-server): una
+  configuración de Nginx para Castopod
+
+Adicionalmente, Castopod requiere una base de datos compatible con MySQL.
+También se puede añadir una base de datos Redis como gestor de caché.
+
+## Etiquetas admitidas
+
+- `develop` [unstable], última rama construída de desarrollo
+- `beta` [stable], última versión beta
+- `latest` [stable], última versión
+- `1.x.x` [stable], versión específica de compilación (desde `1.0.0`)
+
+## Ejemplo de uso
+
+1. Instalar [docker](https://docs.docker.com/get-docker/) y
+   [docker-compose](https://docs.docker.com/compose/install/)
+
+2. Crear un archivo `docker-compose.yml` con lo siguiente:
+
+   ```yml
+   version: "3.7"
+
+   services:
+     app:
+       image: castopod/castopod:latest
+       container_name: "castopod-app"
+       volumes:
+         - castopod-media:/var/www/castopod/public/media
+       environment:
+         MYSQL_DATABASE: castopod
+         MYSQL_USER: castopod
+         MYSQL_PASSWORD: changeme
+         CP_BASEURL: "https://castopod.example.com"
+         CP_ANALYTICS_SALT: changeme
+         CP_CACHE_HANDLER: redis
+         CP_REDIS_HOST: redis
+         CP_REDIS_PASSWORD: changeme
+       networks:
+         - castopod-app
+         - castopod-db
+       ports:
+         - 8000:8000
+       restart: unless-stopped
+
+     mariadb:
+       image: mariadb:10.5
+       container_name: "castopod-mariadb"
+       networks:
+         - castopod-db
+       volumes:
+         - castopod-db:/var/lib/mysql
+       environment:
+         MYSQL_ROOT_PASSWORD: changeme
+         MYSQL_DATABASE: castopod
+         MYSQL_USER: castopod
+         MYSQL_PASSWORD: changeme
+       restart: unless-stopped
+
+     redis:
+       image: redis:7.0-alpine
+       container_name: "castopod-redis"
+       command: --requirepass changeme
+       volumes:
+         - castopod-cache:/data
+       networks:
+         - castopod-app
+
+   volumes:
+     castopod-media:
+     castopod-db:
+     castopod-cache:
+
+   networks:
+     castopod-app:
+     castopod-db:
+   ```
+
+   Debes adaptar algunas variables a tus necesidades (ej. `CP_BASEURL`,
+   `MYSQL_ROOT_PASSWORD`, `MYSQL_PASSWORD` y `CP_ANALYTICS_SALT`).
+
+3. Configura un servidor proxy inverso para TLS (SSL/HTTPS).
+
+   TLS es imprescindible para que ActivityPub funcione. Este trabajo puede ser
+   fácilmente manejado por un proxy inverso, por ejemplo con
+   [Caddy](https://caddyserver.com/):
+
+   ```
+   #castopod
+   castopod.example.com {
+       reverse_proxy localhost:8000
+   }
+   ```
+
+4. Ejecuta `docker-compose -d`, espera a que se inicie y ve a
+   `https://castopod.mi_dominio.com/cp-install` para terminar de configurar
+   Castopod!
+
+5. Todo listo, empieza a hacer podcasting! 🎙️🚀 🎙️🚀
+
+## Variables de Entorno
+
+- **castopod/castopod** and **castopod/app**
+
+  | Nombre de la Variable                 | Tipo (`predeterminado`) | Default          |
+  | ------------------------------------- | ----------------------- | ---------------- |
+  | **`CP_BASEURL`**                      | string                  | `undefined`      |
+  | **`CP_MEDIA_URLBASE`**                | ?string                 | `CP_BASEURL`     |
+  | **`CP_ADMIN_GATEWAY`**                | ?string                 | `"cp-admin"`     |
+  | **`CP_AUTH_GATEWAY`**                 | ?string                 | `"cp-auth"`      |
+  | **`CP_ANALYTICS_SALT`**               | string                  | `undefined`      |
+  | **`CP_DATABASE_HOSTNAME`**            | ?string                 | `"mariadb"`      |
+  | **`CP_DATABASE_NAME`**                | ?string                 | `MYSQL_DATABASE` |
+  | **`CP_DATABASE_USERNAME`**            | ?string                 | `MYSQL_USER`     |
+  | **`CP_DATABASE_PASSWORD`**            | ?string                 | `MYSQL_PASSWORD` |
+  | **`CP_DATABASE_PREFIX`**              | ?string                 | `"cp_"`          |
+  | **`CP_CACHE_HANDLER`**                | [`"file"` o `"redis"`]  | `"file"`         |
+  | **`CP_REDIS_HOST`**                   | ?string                 | `"localhost"`    |
+  | **`CP_REDIS_PASSWORD`**               | ?string                 | `null`           |
+  | **`CP_REDIS_PORT`**                   | ?number                 | `6379`           |
+  | **`CP_REDIS_DATABASE`**               | ?number                 | `0`              |
+  | **`HOST_EMAIL_SMTP_HOST`**            | ?string                 | `undefined`      |
+  | **`CP_EMAIL_FROM`**                   | ?string                 | `undefined`      |
+  | **`CP_EMAIL_SMTP_USERNAME`**          | ?string                 | `"localhost"`    |
+  | **`CP_EMAIL_SMTP_PASSWORD`**          | ?string                 | `null`           |
+  | **`CP_EMAIL_SMTP_PORT`**              | ?number                 | `25`             |
+  | **`CP_EMAIL_SMTP_CRYPTO`**            | [`"tls"` o `"ssl"`]     | `"tls"`          |
+  | **`CP_ENABLE_2FA`**                   | ?boolean                | `undefined`      |
+  | **`CP_MEDIA_FILE_MANAGER`**           | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_ENDPOINT`**            | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_KEY`**                 | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_SECRET`**              | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_REGION`**              | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_BUCKET`**              | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_PROTOCOL`**            | ?number                 | `undefined`      |
+  | **`CP_MEDIA_S3_PATH_STYLE_ENDPOINT`** | ?boolean                | `undefined`      |
+  | **`CP_MEDIA_S3_KEY_PREFIX`**          | ?string                 | `undefined`      |
+  | **`CP_DISABLE_HTTPS`**                | ?[`0` or `1`]           | `undefined`      |
+  | **`CP_MAX_BODY_SIZE`**                | ?number (with suffix)   | `512M`           |
+  | **`CP_PHP_MEMORY_LIMIT`**             | ?number (with suffix)   | `512M`           |
+  | **`CP_TIMEOUT`**                      | ?number                 | `900`            |
+
+- **castopod/servidor web**
+
+  | Nombre de la variable  | Tipo                  | Default |
+  | ---------------------- | --------------------- | ------- |
+  | **`CP_APP_HOSTNAME`**  | ?string               | `"app"` |
+  | **`CP_MAX_BODY_SIZE`** | ?number (with suffix) | `512M`  |
+  | **`CP_TIMEOUT`**       | ?number               | `900`   |
--- a/docs/src/es/getting-started/install.md
+++ b/docs/src/es/getting-started/install.md
 ---
-title: Instalación
-sidebarDepth: 3
+title: ¿Cómo instalar Castopod?
 ---

-# ¿Cómo instalar Castopod?
+import { Aside } from "@astrojs/starlight/components";

 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](./docker.md) para Castopod.
-
-:::
-
 ## Requisitos

- PHP v8.1 o superior
- MySQL versión 5.7 o superior o MariaDB versión 10.2 o superior
+- PHP v8.4 or higher
+- MySQL versión 8.4 o superior o MariaDB versión 11.4 o superior
 - Soporte HTTPS
+- An [ntp-synced clock](https://wiki.debian.org/NTP) to validate federation's
+  incoming requests

-### PHP v8.1 o superior
+### PHP v8.4 or higher

-Se requiere PHP versión 8.1 o superior con las siguientes extensiones
-instaladas:
+PHP version 8.4 or higher is required, with the following extensions installed:

 - [intl](https://php.net/manual/en/intl.requirements.php)
 - [libcurl](https://php.net/manual/en/curl.requirements.php)
@@ -46,14 +37,6 @@ Además, asegúrate de que las siguientes extensiones están habilitadas en tu P

 > Se recomienda usar [MariaDB](https://mariadb.org).

-::: 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.
@@ -93,34 +76,22 @@ extensiones:
   [Castopod](https://castopod.org/), 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:
+4. Add **cron tasks** on your web server for various background processes
+   (replace the paths accordingly):

   ```bash
-      * * * * * /ruta/al/php /ruta/a/castopod/public/index.php scheduled-activities
+      * * * * * /path/to/php /path/to/castopod/spark tasks:run >> /dev/null 2>&1
   ```

-   - Para que tus episodios sean transmitidos a los hubs abiertos que usan el
-     nuevo protocolo [WebSub](https://en.wikipedia.org/wiki/WebSub) (2018):
-
-   ```bash
-      * * * * * /ruta/al/php /castopod/public/index.php scheduled-websub-publish
-   ```
+   **Note** - If you do not add this cron task, the following Castopod features
+   will not work:

-   - Para generar Recortes de video (ver
-     [requisitos FFmpeg ](#ffmpeg-v418-or-higher-for-video-clips)):
-
-   ```bash
-      * * * * * /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.
+   - Importing a podcast from an existing RSS feed
+   - Broadcasting social activities to your followers in the fediverse
+   - Broadcasting episodes to open hubs using
+     [WebSub](https://en.wikipedia.org/wiki/WebSub)
+   - Generating video clips -
+     [requires FFmpeg](#optional-ffmpeg-v418-or-higher-for-video-clips)

 ### (recomendado) Asistente web de instalación

@@ -129,15 +100,33 @@ extensiones:
 2. Sigue las instrucciones en pantalla.
 3. ¡Empieza a hacer podcasting!

-::: info Nota
+<Aside>

 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.

-:::
+</Aside>
+
+### Using CLI
+
+1. Create a `.env` file in the package root based on the `.env.example` file.
+
+2. Initialize the database using:
+
+   ```sh
+   php spark install:init-database
+   ```
+
+3. Create the superadmin user using:

-### Configuración de Correo Electrónico/SMTP
+   ```sh
+   php spark install:create-superadmin
+   ```
+
+4. Head on to your admin gateway to start podcasting!
+
+### Email/SMTP setup

 La configuración del correo electrónico es necesaria para que algunas
 características funcionen correctamente (por ejemplo, recuperar su contraseña
@@ -155,38 +144,104 @@ email.SMTPUser="your_smtp_user"
 email.SMTPPass="your_smtp_password"
 ```

-#### Opciones de configuración de email
+#### Configuración de Correo Electrónico/SMTP
+
+| Nombre de variable | 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"`      |
+
+### Media storage
+
+By default, files are saved to the `public/media` folder using the file system.
+If you need to relocate the `media` folder to a different location, you can
+specify it in your `.env` file as shown below:
+
+```ini
+# […]
+
+media.root="media"
+media.storage="/mnt/storage"
+```

-| 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"`        |
+In this example, the files will be saved to the /mnt/storage/media folder. Make
+sure to also update your web server configuration to reflect this change.
+
+### S3
+
+If you prefer storing your media files on an S3 compatible storage, you may
+specify it in your `.env`:
+
+```ini
+# […]
+
+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
+
+| Nombre de la variable   | Type    | Default     |
+| ----------------------- | ------- | ----------- |
+| **`endpoint`**          | string  | `undefined` |
+| **`key`**               | string  | `undefined` |
+| **`secret`**            | string  | `undefined` |
+| **`region`**            | string  | `undefined` |
+| **`bucket`**            | string  | `castopod`  |
+| **`protocol`**          | number  | `undefined` |
+| **`pathStyleEndpoint`** | boolean | `false`     |
+| **`keyPrefix`**         | string  | `undefined` |

 ## Paquetes de la comunidad

-Si no quieres molestarte en instalar Castopod manualmente, puedes utilizar uno
-de los paquetes creados y mantenidos por la comunidad de código abierto.
+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.

-### Instalar con YunoHost
+### Install with YunoHost

-[YunoHost](https://yunohost.org/) es una distribución GNU/Linux basada en Debian
-compuesta por paquetes de software libre y de código abierto. Te ayuda a
-gestionar las partes difíciles de autoalojamiento.
+[YunoHost](https://yunohost.org/) 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.

 <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="Instalar Castopod con YunoHost." class="align-middle" />
+<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="Instalar Castopod con 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>Github
-Repo</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>
--- a/docs/src/es/getting-started/security.md
+++ b/docs/src/es/getting-started/security.md
 ---
-title: Seguridad
+title: Problemas de seguridad
 ---

-# Problemas de seguridad
-
 Castopod está construido sobre [CodeIgniter4](https://codeigniter.com/), un
 framework de PHP que alienta
 [buenas prácticas de seguridad](https://codeigniter.com/user_guide/concepts/security.html).

--- a/docs/src/es/getting-started/update.md
+++ b/docs/src/es/getting-started/update.md
 ---
-title: Actualización
-sidebarDepth: 3
+title: ¿Cómo actualizar Castopod?
 ---

-# ¿Cómo actualizar Castopod?
+import { Aside } from "@astrojs/starlight/components";

 Después de instalar Castopod, es posible que quieras actualizar tu instancia a
 la última versión para disfrutar de las últimas características ✨, correcciones
@@ -36,13 +35,13 @@ de errores 🐛 y mejoras de rendimiento ⚡.
   - Eliminar todos los archivos excepto `.env` y la carpeta `public/media`
   - Copie los nuevos archivos del paquete descargado en su servidor

-     ::: Nota informativa
+     <Aside>

     Es posible que necesite restablecer los permisos de los archivos después el
     proceso de instalación. Compruebe
     [preocupaciones de seguridad](./security.md).

-     :::
+     </Aside>

 4. Actualice su esquema de base de datos desde su `Administrador de Castopod` >
   `Acerca de` página o ejecutando:
@@ -53,23 +52,22 @@ de errores 🐛 y mejoras de rendimiento ⚡.

 5. Limpia tu caché en `Administrador de Castopod` > `Ajustes` > `general` >
   `Housekeeping`
+
 6. ✨ ¡Disfruta de tu instancia recién instalada, todo listo!

-::: Nota informativa
+<Aside>

 Las versiones pueden venir con instrucciones de actualización adicionales (véase
 la página de
 [lanzamientos](https://code.castopod.org/adaures/castopod/-/releases)).

- cf.
-
-No he actualizado mi instancia en mucho tiempo… ¿Qué debo hacer?</li> </ul>
+- cf. No he actualizado mi instancia en mucho tiempo… ¿Qué debo hacer?

-:::
+</Aside>

 ## Actualizaciones totalmente automatizadas

-> Próximamente...
+> Próximamente... 👀

 ## Preguntas Frecuentes (FAQ)

@@ -83,10 +81,9 @@ Alternativamente, puedes encontrar la versión en el archivo

 ### No he actualizado mi instancia en mucho tiempo… ¿Qué debo hacer?

-¡No hay problema! No problem! Just get the latest release as described above.
-Simplemente cuando vaya a través de las instrucciones de lanzamiento (4),
-realice la actualización secuencialmente, desde el más antiguo hasta el más
-reciente.
+No problem! Just get the latest release as described above. Simplemente cuando
+vaya a través de las instrucciones de lanzamiento (4), realice la actualización
+secuencialmente, desde el más antiguo hasta el más reciente.

 > Puede que quieras hacer una copia de seguridad de tu instancia dependiendo del
 > tiempo que no hayas actualizado Castopod.

--- a/docs/src/content/docs/es/index.mdx
+++ b/docs/src/content/docs/es/index.mdx
+---
+title: Bienvenido 👋
+---
+
+import { LinkCard } from "@astrojs/starlight/components";
+
+Castopod es una plataforma gratuita y de código abierto para hospedar podcasts
+hecha para podcasters que quieren involucrar e interactuar más con su audiencia.
+
+Castopod es fácil de instalar y se ha desarrollado sobre
+[CodeIgniter4](https://codeigniter.com/), un potente y muy ligero framework PHP.
+
+<LinkCard title="Instalación" href="./getting-started/install" />
+
+## Características
+
+- 🌱  Gratis & de código abierto (licencia AGPL v3).
+- 🔐  Centrado en la soberanía de los datos: tu contenido, tu audiencia, y tus
+  estadísticas te pertenecen a ti y solo a ti.
+- 🪄  Funciones de Podcasting 2.0: GUID (interfaz gráfica de usuario),
+  protección y bloqueo del podcast, transcripciones, monetización, episodios,
+  geo-localización, personas, fragmentos de audio, …
+- 💬  Integración con redes sociales:
+  - 🚀  Castopod es parte del Fediverso, una red social descentralizada
+  - ❤️  Se puede crear mensajes, compartir, agregar a favoritos y comentar en
+    episodios
+- 📈  Análisis estadísticos integrados:
+  - ⚖️  Compatible con GDPR / CCPA / LGPD
+  - 🪙  Medida de audiencia con el estándar IABv2
+  - 🏡  On-premises analytics, no third party involved
+- 📢  Herramientas de marketing incorporadas:
+  - ✅  Listo para SEO (meta-etiquetas de open-graph, JSON-LD, …)
+  - 📱  PWA: instalable como una aplicación independiente
+  - 🎨  Personalizar los colores del tema
+  - 🎬  Generar recortes de vídeo listos para compartir, a partir de tus
+    episodios
+  - 🔉  Generate soundbites
+  - ▶️  Reproductor incrustable, con el que insertar tus episodios en cualquier
+    sitio web!
+- 💸  Monetización:
+  - 🔗  Enlaces de financiación
+  - 📲  Anuncios publicitarios del tipo click-para-escuchar
+  - 🤝  value4value / WebMonetization (criptomonedas para creadores de
+    contenido).
+  - 💎  Premium podcasts
+- 📡  Publica tus episodios en todas partes con RSS:
+  - 📱  En todos los directorios y aplicaciones: Podcast Index, Apple Podcasts,
+    Spotify, Google Podcasts, Deezer, Podcast Addict, Podfriend, …
+  - ⚡  Emite tus episodios al instante con WebSub.
+- 📥  Importación de podcasts: mueve tu podcast existente en otro servicio a tu
+  servidor Castopod.
+- 📤  Mueve tu podcast fuera de Castopod.
+- 🔀  Multi-podcast: aloja tantos podcasts como quieras en una misma
+  instancia/panel de CASTOPOD.
+- 👥  Multi-usuario: añade colaboradores y define roles.
+- 🌎  Soporte multilingüe i18n: traducido al Inglés, Francés, Polaco, Alemán,
+  Portugués brasileño, Español, Noruego, … ¡y
+  [más por venir](https://translate.castopod.org)!
+
+## Motivación
+
+The podcasting ecosystem is decentralized by nature: you can create your podcast
+as an RSS file, publish it on the web and have it shared everywhere online.
+
+It is in fact one of the only media to have stayed this way for a long time.
+
+As usages are evolving, more and more people are getting into podcasts: whether
+it is creators finding new ways to share their ideas, or listeners in the search
+for better content.
+
+With podcasting becoming more widely used, some companies are trying to shift it
+towards a more controlled and centralized medium.
+
+Castopod was created in an effort to provide an open and sustainable alternative
+to hosting your podcasts, promoting decentralization to ensure that podcasters
+creativity can express itself.
+
+This project is pushed by the open-source community, and specifically by the
+[Fediverse](https://fediverse.party/en/fediverse/) and
+[Podcasting 2.0](https://podcastindex.org/) movements.
+
+## Comparación con otras soluciones
+
+We believe that a solution is not necessarily right for everyone, it highly
+depends on your needs. So, here are comparisons with other tools to help you to
+gauge whether Castopod is the right fit for you.
+
+### Castopod vs. Wordpress
+
+Castopod is often referred to as "the Wordpress for podcasts" because of the
+similarities between the two. In some ways this is true. And actually, Castopod
+was greatly inspired by the Wordpress ecosystem, seeing the ease of adoption
+from the community and the number of websites running it.
+
+Just like Wordpress, Castopod is free & open source, built using PHP with a
+MySQL database and is packaged in a way that you can easily install on most web
+servers.
+
+Wordpress is a great way to create your website and extend it with plugins to
+get what you want. It is a full fledged CMS that helps you get any type of
+website online.
+
+On the other hand, Castopod is meant to address the podcasters needs
+specifically, focusing on podcasting, and nothing else. You don't need any
+plugin to get you started on your podcasting journey.
+
+This allows optimizing the processes specific to podcasting: ranging from the
+creation of your podcasts and the publication of new episodes all the way to
+broadcasting, marketing and analytics.
+
+Finally, depending on your needs, Wordpress and Castopod can even live side by
+side as they share the same requirements!
+
+### Castopod vs. Funkwhale
+
+Funkwhale is a self-hosted, modern free and open-source music server. Just as
+Castopod, Funkwhale is on the fediverse, a decentralized social network allowing
+interoperability between the two.
+
+Funkwhale was initially built around music. And later on, as the project
+evolved, the ability to host podcasts was introduced.
+
+Unlike Funkwhale, Castopod has been designed and built around podcasting
+exclusively. This allows easier implementation for features related to the
+podcasting ecosystem, such as the podcasting 2.0 features (transcripts,
+chapters, locations, persons, …).
+
+So, you should probably use Funkwhale if you want to host your music, and use
+Castopod if you want to host your podcasts.
+
+### Castopod vs. otras plataformas de podcast
+
+There are many solutions for you to host your podcasts, some of which are really
+great and [a lot of them](https://podcastindex.org/apps) are jumping into the
+Podcasting 2.0 wagon just like Castopod!
+
+Each of these solutions differ from one another, you may compare with the
+[list of features](#features).
+
+That being said, there are two main differences with other podcasting solutions:
+
+- Castopod puede ser auto-hospedado en tu propio servidor y es la única solución
+  que te permite mantener un control completo sobre los contenidos que produces.
+  También, como es de código abierto, puedes incluso personalizarlo como desees
+  y necesites.
+
+- Castopod es la única solución que hasta el momento integra tanto una red
+  social descentralizada con ActivityPub así como muchas de las características
+  del podcasting 2.0, con la esperanza de cerrar la brecha entre ambos.
+
+## Contributing
+
+Love Castopod and would like to help? Take a look at the following documentation
+to get you started.
+
+### Código de conducta
+
+Castopod has adopted a Code of Conduct that we expect project participants to
+adhere to. Please read the
+[CODE_OF_CONDUCT manual](https://code.castopod.org/adaures/castopod/-/blob/beta/CODE_OF_CONDUCT.md)
+so that you can understand what actions will and will not be tolerated.
+
+### Guía para colaborar
+
+Read our [contributing guide](../contributing/guidelines.md) to learn about our
+development process, how to propose bugfixes and improvements, and how to build
+and test your changes to Castopod.
+
+## Contacto
+
+You may reach us for help or ask any question you have on:
+
+- [Discord](https://castopod.org/discord) (para interacción directa con
+  desarrolladores y la comunidad)
+- [Seguimiento de incidencias](https://code.castopod.org/adaures/castopod/-/issues)
+  (para informar de errores y solicitar nuevas funcionalidades)
+
+Alternatively, you can follow us on social media platforms to get news about
+Castopod:
+
+- [podlibre.social](https://podlibre.social/@castopod) (instancia de Mastodon)
+- [\[Twitter\](https://twitter.com/castopod)](https://twitter.com/castopod)
+- [\[LinkedIn\](https://linkedin.com/company/ad-aures)](https://linkedin.com/company/castopod)
+- [Facebook (próximamente?)](https://www.facebook.com/castopod)
+
+## Sponsors
+
+The ongoing development of Castopod is made possible with the support of its
+backers. If you'd like to help, please consider
+[sponsoring Castopod's development](https://opencollective.com/castopod/contribute).
+
+[![Ad Aures Logo](../../../assets/images/sponsors/adaures.svg)](https://adaures.com/)
+
+[![NLnet Logo](../../../assets/images/sponsors/nlnet.svg)](https://nlnet.nl/)
+
+## Licencia
+
+[GNU Affero General Public License v3.0](https://choosealicense.com/licenses/agpl-3.0/)
+
+Copyright © 2020-present, [Ad Aures](https://adaures.com/).
--- a/docs/src/br/getting-started/auth.md
+++ b/docs/src/br/getting-started/auth.md
 ---
 title: Authentication & Authorization
-sidebarDepth: 3
 ---

-# Authentication & Authorization
-
 Castopod handles authentication and authorization using `codeigniter/shield`
 coupled with custom rules. Roles and permissions are defined at two levels:

@@ -15,24 +12,25 @@ coupled with custom rules. Roles and permissions are defined at two levels:

 ### Instance roles

-<!-- AUTH-INSTANCE-ROLES-LIST:START - Do not remove or modify this section -->
+{/* AUTH-INSTANCE-ROLES-LIST:START - Do not remove or modify this section */}

-| role        | description                         | permissions                                                                                |
-| ----------- | ----------------------------------- | ------------------------------------------------------------------------------------------ |
-| Super admin | Has complete control over Castopod. | admin.\*, podcasts.\*, users.manage, persons.manage, pages.manage, fediverse.manage-blocks |
-| Manager     | Manages Castopod's content.         | podcasts.create, podcasts.import, persons.manage, pages.manage                             |
-| Podcaster   | General users of Castopod.          | admin.access                                                                               |
+| role        | description                         | permissions                                                                                            |
+| ----------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| Super admin | Has complete control over Castopod. | admin.\*, plugins.\*, podcasts.\*, users.manage, persons.manage, pages.manage, fediverse.manage-blocks |
+| Manager     | Manages Castopod's content.         | podcasts.create, podcasts.import, persons.manage, pages.manage                                         |
+| Podcaster   | General users of Castopod.          | admin.access                                                                                           |

-<!-- AUTH-INSTANCE-ROLES-LIST:END -->
+{/* AUTH-INSTANCE-ROLES-LIST:END */}

 ### Instance permissions

-<!-- AUTH-INSTANCE-PERMISSIONS-LIST:START - Do not remove or modify this section -->
+{/* AUTH-INSTANCE-PERMISSIONS-LIST:START - Do not remove or modify this section */}

 | permission              | description                                                        |
 | ----------------------- | ------------------------------------------------------------------ |
 | admin.access            | Can access the Castopod admin area.                                |
 | admin.settings          | Can access the Castopod settings.                                  |
+| plugins.manage          | Auth.instance_permissions.plugins.manage                           |
 | users.manage            | Can manage Castopod users.                                         |
 | persons.manage          | Can manage persons.                                                |
 | pages.manage            | Can manage pages.                                                  |
@@ -41,47 +39,47 @@ coupled with custom rules. Roles and permissions are defined at two levels:
 | podcasts.import         | Can import podcasts.                                               |
 | fediverse.manage-blocks | Can block fediverse actors/domains from interacting with Castopod. |

-<!-- AUTH-INSTANCE-PERMISSIONS-LIST:END -->
+{/* AUTH-INSTANCE-PERMISSIONS-LIST:END */}

 ## 2. Per podcast roles and permissions

 ### Per podcast roles

-<!-- AUTH-PODCAST-ROLES-LIST:START - Do not remove or modify this section -->
+{/* AUTH-PODCAST-ROLES-LIST:START - Do not remove or modify this section */}

-| role   | description                                               | permissions                                                                                                                                                                                                                                                                                          |
-| ------ | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Admin  | Has complete control of podcast #{id}.                    | \*                                                                                                                                                                                                                                                                                                   |
-| Editor | Manages content and publications of podcast #{id}.        | view, edit, manage-import, manage-persons, manage-platforms, manage-publications, interact-as, episodes.view, episodes.create, episodes.edit, episodes.delete, episodes.manage-persons, episodes.manage-clips, episodes.manage-publications, episodes.manage-comments, episodes.manage-notifications |
-| Author | Manages content of podcast #{id} but cannot publish them. | view, manage-persons, episodes.view, episodes.create, episodes.edit, episodes.manage-persons, episodes.manage-clips                                                                                                                                                                                  |
-| Guest  | General contributor of the podcast #{id}.                 | view, episodes.view                                                                                                                                                                                                                                                                                  |
+| role   | description                                                 | permissions                                                                                                                                                                                                                                                                                 |
+| ------ | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Admin  | Has complete control of podcast #\{id\}.                    | \*                                                                                                                                                                                                                                                                                          |
+| Editor | Manages content and publications of podcast #\{id\}.        | view, edit, manage-import, manage-persons, manage-platforms, manage-publications, manage-notifications, interact-as, episodes.view, episodes.create, episodes.edit, episodes.delete, episodes.manage-persons, episodes.manage-clips, episodes.manage-publications, episodes.manage-comments |
+| Author | Manages content of podcast #\{id\} but cannot publish them. | view, manage-persons, episodes.view, episodes.create, episodes.edit, episodes.manage-persons, episodes.manage-clips                                                                                                                                                                         |
+| Guest  | General contributor of the podcast #\{id\}.                 | view, episodes.view                                                                                                                                                                                                                                                                         |

-<!-- AUTH-PODCAST-ROLES-LIST:END -->
+{/* AUTH-PODCAST-ROLES-LIST:END */}

 ### Per podcast permissions

-<!-- AUTH-PODCAST-PERMISSIONS-LIST:START - Do not remove or modify this section -->
-
-| permission                   | description                                                              |
-| ---------------------------- | ------------------------------------------------------------------------ |
-| view                         | Can view dashboard and analytics of podcast #{id}.                       |
-| edit                         | Can edit podcast #{id}.                                                  |
-| delete                       | Can delete podcast #{id}.                                                |
-| manage-import                | Can synchronize imported podcast #{id}.                                  |
-| manage-persons               | Can manage subscriptions of podcast #{id}.                               |
-| manage-subscriptions         | Can manage subscriptions of podcast #{id}.                               |
-| manage-contributors          | Can manage contributors of podcast #{id}.                                |
-| manage-platforms             | Can set/remove platform links of podcast #{id}.                          |
-| manage-publications          | Can publish podcast #{id}.                                               |
-| manage-notifications         | Can view and mark notifications as read for podcast #{id}.               |
-| interact-as                  | Can interact as the podcast #{id} to favourite, share or reply to posts. |
-| episodes.view                | Can view dashboard and analytics of podcast #{id}.                       |
-| episodes.create              | Can create episodes for podcast #{id}.                                   |
-| episodes.edit                | Can edit podcast #{id}.                                                  |
-| episodes.delete              | Can delete podcast #{id}.                                                |
-| episodes.manage-persons      | Can manage subscriptions of podcast #{id}.                               |
-| episodes.manage-clips        | Can manage video clips or soundbites of podcast #{id}.                   |
-| episodes.manage-publications | Can publish podcast #{id}.                                               |
-| episodes.manage-comments     | Can create/remove episode comments of podcast #{id}.                     |
-
-<!-- AUTH-PODCAST-PERMISSIONS-LIST:END -->
+{/* AUTH-PODCAST-PERMISSIONS-LIST:START - Do not remove or modify this section */}
+
+| permission                   | description                                                                |
+| ---------------------------- | -------------------------------------------------------------------------- |
+| view                         | Can view dashboard and analytics of podcast #\{id\}.                       |
+| edit                         | Can edit podcast #\{id\}.                                                  |
+| delete                       | Can delete podcast #\{id\}.                                                |
+| manage-import                | Can synchronize imported podcast #\{id\}.                                  |
+| manage-persons               | Can manage subscriptions of podcast #\{id\}.                               |
+| manage-subscriptions         | Can manage subscriptions of podcast #\{id\}.                               |
+| manage-contributors          | Can manage contributors of podcast #\{id\}.                                |
+| manage-platforms             | Can set/remove platform links of podcast #\{id\}.                          |
+| manage-publications          | Can publish podcast #\{id\}.                                               |
+| manage-notifications         | Can view and mark notifications as read for podcast #\{id\}.               |
+| interact-as                  | Can interact as the podcast #\{id\} to favourite, share or reply to posts. |
+| episodes.view                | Can view dashboards and analytics of podcast #\{id\}'s episodes.           |
+| episodes.create              | Can create episodes for podcast #\{id\}.                                   |
+| episodes.edit                | Can edit episodes of podcast #\{id\}.                                      |
+| episodes.delete              | Can delete episodes of podcast #\{id\}.                                    |
+| episodes.manage-persons      | Can manage episode persons of podcast #\{id\}.                             |
+| episodes.manage-clips        | Can manage video clips or soundbites of podcast #\{id\}.                   |
+| episodes.manage-publications | Can publish/unpublish episodes and posts of podcast #\{id\}.               |
+| episodes.manage-comments     | Can create/remove episode comments of podcast #\{id\}.                     |
+
+{/* AUTH-PODCAST-PERMISSIONS-LIST:END */}
--- a/docs/src/content/docs/eu/getting-started/docker.mdx
+++ b/docs/src/content/docs/eu/getting-started/docker.mdx
+---
+title: Official Docker images
+---
+
+Castopod pushes 3 Docker images to the Docker Hub during its automated build
+process:
+
+- [**`castopod/castopod`**](https://hub.docker.com/r/castopod/castopod): an all
+  in one castopod image using nginx unit
+- [**`castopod/app`**](https://hub.docker.com/r/castopod/app): the app bundle
+  with all of Castopod dependencies
+- [**`castopod/web-server`**](https://hub.docker.com/r/castopod/web-server): an
+  Nginx configuration for Castopod
+
+Additionally, Castopod requires a MySQL-compatible database. A Redis database
+can be added as a cache handler.
+
+## Supported tags
+
+- `develop` [unstable], latest development branch build
+- `beta` [stable], latest beta version build
+- `latest` [stable], latest version build
+- `1.x.x` [stable], specific version build (since `1.0.0`)
+
+## Example usage
+
+1. Install [docker](https://docs.docker.com/get-docker/) and
+   [docker-compose](https://docs.docker.com/compose/install/)
+
+2. Create a `docker-compose.yml` file with the following:
+
+   ```yml
+   version: "3.7"
+
+   services:
+     app:
+       image: castopod/castopod:latest
+       container_name: "castopod-app"
+       volumes:
+         - castopod-media:/var/www/castopod/public/media
+       environment:
+         MYSQL_DATABASE: castopod
+         MYSQL_USER: castopod
+         MYSQL_PASSWORD: changeme
+         CP_BASEURL: "https://castopod.example.com"
+         CP_ANALYTICS_SALT: changeme
+         CP_CACHE_HANDLER: redis
+         CP_REDIS_HOST: redis
+         CP_REDIS_PASSWORD: changeme
+       networks:
+         - castopod-app
+         - castopod-db
+       ports:
+         - 8000:8000
+       restart: unless-stopped
+
+     mariadb:
+       image: mariadb:10.5
+       container_name: "castopod-mariadb"
+       networks:
+         - castopod-db
+       volumes:
+         - castopod-db:/var/lib/mysql
+       environment:
+         MYSQL_ROOT_PASSWORD: changeme
+         MYSQL_DATABASE: castopod
+         MYSQL_USER: castopod
+         MYSQL_PASSWORD: changeme
+       restart: unless-stopped
+
+     redis:
+       image: redis:7.0-alpine
+       container_name: "castopod-redis"
+       command: --requirepass changeme
+       volumes:
+         - castopod-cache:/data
+       networks:
+         - castopod-app
+
+   volumes:
+     castopod-media:
+     castopod-db:
+     castopod-cache:
+
+   networks:
+     castopod-app:
+     castopod-db:
+   ```
+
+   You have to adapt some variables to your needs (e.g. `CP_BASEURL`,
+   `MYSQL_ROOT_PASSWORD`, `MYSQL_PASSWORD` and `CP_ANALYTICS_SALT`).
+
+3. Setup a reverse proxy for TLS (SSL/HTTPS)
+
+   TLS is mandatory for ActivityPub to work. This job can easily be handled by a
+   reverse proxy, for example with [Caddy](https://caddyserver.com/):
+
+   ```
+   #castopod
+   castopod.example.com {
+       reverse_proxy localhost:8000
+   }
+   ```
+
+4. Run `docker-compose up -d`, wait for it to initialize and head on to
+   `https://castopod.example.com/cp-install` to finish setting up Castopod!
+
+5. You're all set, start podcasting! 🎙️🚀
+
+## Environment Variables
+
+- **castopod/castopod** and **castopod/app**
+
+  | Variable name                         | Type (`default`)        | Default          |
+  | ------------------------------------- | ----------------------- | ---------------- |
+  | **`CP_BASEURL`**                      | string                  | `undefined`      |
+  | **`CP_MEDIA_BASEURL`**                | ?string                 | `CP_BASEURL`     |
+  | **`CP_ADMIN_GATEWAY`**                | ?string                 | `"cp-admin"`     |
+  | **`CP_AUTH_GATEWAY`**                 | ?string                 | `"cp-auth"`      |
+  | **`CP_ANALYTICS_SALT`**               | string                  | `undefined`      |
+  | **`CP_DATABASE_HOSTNAME`**            | ?string                 | `"mariadb"`      |
+  | **`CP_DATABASE_NAME`**                | ?string                 | `MYSQL_DATABASE` |
+  | **`CP_DATABASE_USERNAME`**            | ?string                 | `MYSQL_USER`     |
+  | **`CP_DATABASE_PASSWORD`**            | ?string                 | `MYSQL_PASSWORD` |
+  | **`CP_DATABASE_PREFIX`**              | ?string                 | `"cp_"`          |
+  | **`CP_CACHE_HANDLER`**                | [`"file"` or `"redis"`] | `"file"`         |
+  | **`CP_REDIS_HOST`**                   | ?string                 | `"localhost"`    |
+  | **`CP_REDIS_PASSWORD`**               | ?string                 | `null`           |
+  | **`CP_REDIS_PORT`**                   | ?number                 | `6379`           |
+  | **`CP_REDIS_DATABASE`**               | ?number                 | `0`              |
+  | **`CP_EMAIL_SMTP_HOST`**              | ?string                 | `undefined`      |
+  | **`CP_EMAIL_FROM`**                   | ?string                 | `undefined`      |
+  | **`CP_EMAIL_SMTP_USERNAME`**          | ?string                 | `"localhost"`    |
+  | **`CP_EMAIL_SMTP_PASSWORD`**          | ?string                 | `null`           |
+  | **`CP_EMAIL_SMTP_PORT`**              | ?number                 | `25`             |
+  | **`CP_EMAIL_SMTP_CRYPTO`**            | [`"tls"` or `"ssl"`]    | `"tls"`          |
+  | **`CP_ENABLE_2FA`**                   | ?boolean                | `undefined`      |
+  | **`CP_MEDIA_FILE_MANAGER`**           | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_ENDPOINT`**            | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_KEY`**                 | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_SECRET`**              | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_REGION`**              | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_BUCKET`**              | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_PROTOCOL`**            | ?number                 | `undefined`      |
+  | **`CP_MEDIA_S3_PATH_STYLE_ENDPOINT`** | ?boolean                | `undefined`      |
+  | **`CP_MEDIA_S3_KEY_PREFIX`**          | ?string                 | `undefined`      |
+  | **`CP_DISABLE_HTTPS`**                | ?[`0` or `1`]           | `undefined`      |
+  | **`CP_MAX_BODY_SIZE`**                | ?number (with suffix)   | `512M`           |
+  | **`CP_PHP_MEMORY_LIMIT`**             | ?number (with suffix)   | `512M`           |
+  | **`CP_TIMEOUT`**                      | ?number                 | `900`            |
+
+- **castopod/web-server**
+
+  | Variable name          | Type                  | Default |
+  | ---------------------- | --------------------- | ------- |
+  | **`CP_APP_HOSTNAME`**  | ?string               | `"app"` |
+  | **`CP_MAX_BODY_SIZE`** | ?number (with suffix) | `512M`  |
+  | **`CP_TIMEOUT`**       | ?number               | `900`   |
--- a/docs/src/br/getting-started/install.md
+++ b/docs/src/br/getting-started/install.md
 ---
-title: Staliañ
-sidebarDepth: 3
+title: How to install Castopod?
 ---

-# Penaos staliañ Castopod?
+import { Aside } from "@astrojs/starlight/components";

 Castopod was thought-out to be easy to install. Whether using dedicated or
 shared hosting, you can install it on most PHP-MySQL compatible web servers.

-::: tip Note
-
-We've released official Docker images for Castopod!
-
-If you prefer using Docker, you may skip this and go straight to the
-[docker documentation](./docker.md) for Castopod.
-
-:::
-
 ## Requirements

- PHP v8.1 or higher
- MySQL version 5.7 or higher or MariaDB version 10.2 or higher
+- PHP v8.4 or higher
+- MySQL version 8.4 or higher or MariaDB version 11.4 or higher
 - HTTPS support
+- An [ntp-synced clock](https://wiki.debian.org/NTP) to validate federation's
+  incoming requests

-### PHP v8.1 or higher
+### PHP v8.4 or higher

-PHP version 8.1 or higher is required, with the following extensions installed:
+PHP version 8.4 or higher is required, with the following extensions installed:

 - [intl](https://php.net/manual/en/intl.requirements.php)
 - [libcurl](https://php.net/manual/en/curl.requirements.php)
@@ -44,14 +36,6 @@ Additionally, make sure that the following extensions are enabled in your PHP:

 > We recommend using [MariaDB](https://mariadb.org).

-::: warning Warning
-
-Castopod only works with supported MySQL 5.7 or higher compatible databases. It
-will break with the previous MySQL v5.6 for example as its end of life was on
-February 5, 2021.
-
-:::
-
 You will need the server hostname, database name, username and password to
 complete the installation process. If you do not have these, please contact your
 server administrator.
@@ -92,29 +76,19 @@ want to generate Video Clips. The following extensions must be installed:
 4. Add **cron tasks** on your web server for various background processes
   (replace the paths accordingly):

-   - For social features to work properly, this task is used to broadcast social
-     activities to your followers on the fediverse:
-
   ```bash
-      * * * * * /path/to/php /path/to/castopod/public/index.php scheduled-activities
+      * * * * * /path/to/php /path/to/castopod/spark tasks:run >> /dev/null 2>&1
   ```

-   - For having your episodes be broadcasted on open hubs upon publication using
-     [WebSub](https://en.wikipedia.org/wiki/WebSub):
-
-   ```bash
-      * * * * * /usr/local/bin/php /castopod/public/index.php scheduled-websub-publish
-   ```
+   **Note** - If you do not add this cron task, the following Castopod features
+   will not work:

-   - For Video Clips to be created (see
-     [FFmpeg requirements](#ffmpeg-v418-or-higher-for-video-clips)):
-
-   ```bash
-      * * * * * /path/to/php /path/to/castopod/public/index.php scheduled-video-clips
-   ```
-
-   > These tasks run **every minute**. You may set the frequency depending on
-   > your needs: every 5, 10 minutes or more.
+   - Importing a podcast from an existing RSS feed
+   - Broadcasting social activities to your followers in the fediverse
+   - Broadcasting episodes to open hubs using
+     [WebSub](https://en.wikipedia.org/wiki/WebSub)
+   - Generating video clips -
+     [requires FFmpeg](#optional-ffmpeg-v418-or-higher-for-video-clips)

 ### (recommended) Install Wizard

@@ -123,13 +97,31 @@ want to generate Video Clips. The following extensions must be installed:
 2. Follow the instructions on your screen.
 3. Start podcasting!

-::: info Note
+<Aside>

 The install script writes a `.env` file in the package root. If you cannot go
 through the install wizard, you can create and edit the `.env` file manually
 based on the `.env.example` file.

-:::
+</Aside>
+
+### Using CLI
+
+1. Create a `.env` file in the package root based on the `.env.example` file.
+
+2. Initialize the database using:
+
+   ```sh
+   php spark install:init-database
+   ```
+
+3. Create the superadmin user using:
+
+   ```sh
+   php spark install:create-superadmin
+   ```
+
+4. Head on to your admin gateway to start podcasting!

 ### Email/SMTP setup

@@ -160,6 +152,50 @@ email.SMTPPass="your_smtp_password"
 | **`SMTPPort`**   | number               | `25`         |
 | **`SMTPCrypto`** | [`"tls"` or `"ssl"`] | `"tls"`      |

+### Media storage
+
+By default, files are saved to the `public/media` folder using the file system.
+If you need to relocate the `media` folder to a different location, you can
+specify it in your `.env` file as shown below:
+
+```ini
+# […]
+
+media.root="media"
+media.storage="/mnt/storage"
+```
+
+In this example, the files will be saved to the /mnt/storage/media folder. Make
+sure to also update your web server configuration to reflect this change.
+
+### S3
+
+If you prefer storing your media files on an S3 compatible storage, you may
+specify it in your `.env`:
+
+```ini
+# […]
+
+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` |
+| **`pathStyleEndpoint`** | boolean | `false`     |
+| **`keyPrefix`**         | string  | `undefined` |
+
 ## Community packages

 If you don't want to bother with installing Castopod manually, you may use one
@@ -173,13 +209,35 @@ self-hosting for you.

 <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="Install Castopod with YunoHost" class="align-middle" />
+<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="Install Castopod with 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>Github
-Repo</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>
--- a/docs/src/el/getting-started/security.md
+++ b/docs/src/el/getting-started/security.md
 ---
-title: Security
+title: Security concerns
 ---

-# Security concerns
-
 Castopod is built on top of [CodeIgniter4](https://codeigniter.com/), a PHP
 framework that encourages
 [good security practices](https://codeigniter.com/user_guide/concepts/security.html).

--- a/docs/src/de/getting-started/update.md
+++ b/docs/src/de/getting-started/update.md
 ---
-title: Update
-sidebarDepth: 3
+title: How to update Castopod?
 ---

-# How to update Castopod?
+import { Aside } from "@astrojs/starlight/components";

 After installing Castopod, you may want to update your instance to the latest
 version in order to enjoy the latest features ✨, bug fixes 🐛 and performance
@@ -36,12 +35,12 @@ improvements ⚡.
   - Remove all files except `.env` and `public/media`
   - Copy the new files from the downloaded package into your server

-     ::: info Note
+     <Aside>

     You may need to reset files permissions as during the install process.
     Check [Security Concerns](./security.md).

-     :::
+     </Aside>

 4. Update your database schema from your `Castopod Admin` > `About` page or by
   running:
@@ -52,9 +51,10 @@ improvements ⚡.

 5. Clear your cache from your `Castopod Admin` > `Settings` > `general` >
   `Housekeeping`
+
 6. ✨ Enjoy your fresh instance, you're all done!

-::: info Note
+<Aside>

 Releases may come with additional update instructions (see
 [releases page](https://code.castopod.org/adaures/castopod/-/releases)).
@@ -62,7 +62,7 @@ Releases may come with additional update instructions (see
 - cf.
  [I haven't updated my instance in a long time… What should I do?](#i-havent-updated-my-instance-in-a-long-time-what-should-i-do)

-:::
+</Aside>

 ## Fully Automated updates


--- a/docs/src/content/docs/eu/index.mdx
+++ b/docs/src/content/docs/eu/index.mdx
+---
+title: Welcome 👋
+---
+
+import { LinkCard } from "@astrojs/starlight/components";
+
+Castopod is a free & open-source hosting platform made for podcasters who want
+engage and interact with their audience.
+
+Castopod is easy to install and was built on top of
+[CodeIgniter4](https://codeigniter.com/), a powerful PHP framework with a very
+small footprint.
+
+<LinkCard title="Install" href="./getting-started/install" />
+
+## Features
+
+- 🌱  Free & open-source (AGPL v3 License)
+- 🔐  Focused on data sovereignty: your content, audience, and analytics belong
+  to you, and you only
+- 🪄  Podcasting 2.0 features: GUID, locked, transcripts, funding, chapters,
+  location, persons, soundbites, …
+- 💬  Built-in social network:
+  - 🚀  Castopod is part of the Fediverse, a decentralized social network
+  - ❤️  Create posts, share, favourite, and comment on episodes
+- 📈  Built-in analytics:
+  - ⚖️  GDPR / CCPA / LGPD compliant
+  - 🪙  Standard IABv2 audience measurement
+  - 🏡  On-premises analytics, no third party involved
+- 📢  Built-in marketing tools:
+  - ✅  SEO ready (open-graph meta-tags, JSON-LD, …)
+  - 📱  PWA: install as a standalone app
+  - 🎨  Customizable theme colors
+  - 🎬  Generate ready-to-share Video clips from episodes
+  - 🔉  Generate soundbites
+  - ▶️  Embeddable player, embed your episodes on any website
+- 💸  Monetization:
+  - 🔗  Funding links
+  - 📲  listen-to-click ads
+  - 🤝  value4value / WebMonetization
+  - 💎  Premium podcasts
+- 📡  Publish your episodes everywhere with RSS:
+  - 📱  On all indexes and apps: Podcast Index, Apple Podcasts, Spotify, Google
+    Podcasts, Deezer, Podcast Addict, Podfriend, …
+  - ⚡  Broadcast your episodes instantly with WebSub
+- 📥  Podcast import: move your existing podcast into Castopod
+- 📤  Move your podcast out of Castopod
+- 🔀  Multi-tenant: host as many podcasts as you want
+- 👥  Multi-user: add contributors and set roles
+- 🌎  i18n support: translated in English, French, Polish, German, Brazilian
+  Portuguese, Spanish, simplified Chinese… and
+  [many more](https://translate.castopod.org)!
+
+## Motivation
+
+The podcasting ecosystem is decentralized by nature: you can create your podcast
+as an RSS file, publish it on the web and have it shared everywhere online.
+
+It is in fact one of the only media to have stayed this way for a long time.
+
+As usages are evolving, more and more people are getting into podcasts: whether
+it is creators finding new ways to share their ideas, or listeners in the search
+for better content.
+
+With podcasting becoming more widely used, some companies are trying to shift it
+towards a more controlled and centralized medium.
+
+Castopod was created in an effort to provide an open and sustainable alternative
+to hosting your podcasts, promoting decentralization to ensure that podcasters
+creativity can express itself.
+
+This project is pushed by the open-source community, and specifically by the
+[Fediverse](https://fediverse.party/en/fediverse/) and
+[Podcasting 2.0](https://podcastindex.org/) movements.
+
+## Comparison with other solutions
+
+We believe that a solution is not necessarily right for everyone, it highly
+depends on your needs. So, here are comparisons with other tools to help you to
+gauge whether Castopod is the right fit for you.
+
+### Castopod vs Wordpress
+
+Castopod is often referred to as "the Wordpress for podcasts" because of the
+similarities between the two. In some ways this is true. And actually, Castopod
+was greatly inspired by the Wordpress ecosystem, seeing the ease of adoption
+from the community and the number of websites running it.
+
+Just like Wordpress, Castopod is free & open source, built using PHP with a
+MySQL database and is packaged in a way that you can easily install on most web
+servers.
+
+Wordpress is a great way to create your website and extend it with plugins to
+get what you want. It is a full fledged CMS that helps you get any type of
+website online.
+
+On the other hand, Castopod is meant to address the podcasters needs
+specifically, focusing on podcasting, and nothing else. You don't need any
+plugin to get you started on your podcasting journey.
+
+This allows optimizing the processes specific to podcasting: ranging from the
+creation of your podcasts and the publication of new episodes all the way to
+broadcasting, marketing and analytics.
+
+Finally, depending on your needs, Wordpress and Castopod can even live side by
+side as they share the same requirements!
+
+### Castopod vs Funkwhale
+
+Funkwhale is a self-hosted, modern free and open-source music server. Just as
+Castopod, Funkwhale is on the fediverse, a decentralized social network allowing
+interoperability between the two.
+
+Funkwhale was initially built around music. And later on, as the project
+evolved, the ability to host podcasts was introduced.
+
+Unlike Funkwhale, Castopod has been designed and built around podcasting
+exclusively. This allows easier implementation for features related to the
+podcasting ecosystem, such as the podcasting 2.0 features (transcripts,
+chapters, locations, persons, …).
+
+So, you should probably use Funkwhale if you want to host your music, and use
+Castopod if you want to host your podcasts.
+
+### Castopod vs other podcast hosts
+
+There are many solutions for you to host your podcasts, some of which are really
+great and [a lot of them](https://podcastindex.org/apps) are jumping into the
+Podcasting 2.0 wagon just like Castopod!
+
+Each of these solutions differ from one another, you may compare with the
+[list of features](#features).
+
+That being said, there are two main differences with other podcasting solutions:
+
+- Castopod can be self-hosted and is the only solution that allows you to keep
+  full control over what you produce. Also, as it is open-source, you can even
+  customize it as you wish.
+
+- Castopod is the only solution that currently integrates both a decentralized
+  social network with ActivityPub as well as many of the podcasting 2.0
+  features, hoping to bridge the gap between the two.
+
+## Contributing
+
+Love Castopod and would like to help? Take a look at the following documentation
+to get you started.
+
+### Code of conduct
+
+Castopod has adopted a Code of Conduct that we expect project participants to
+adhere to. Please read the
+[CODE_OF_CONDUCT manual](https://code.castopod.org/adaures/castopod/-/blob/beta/CODE_OF_CONDUCT.md)
+so that you can understand what actions will and will not be tolerated.
+
+### Contributing guide
+
+Read our [contributing guide](./contributing/guidelines.md) to learn about our
+development process, how to propose bugfixes and improvements, and how to build
+and test your changes to Castopod.
+
+## Contact
+
+You may reach us for help or ask any question you have on:
+
+- [Discord](https://castopod.org/discord) (for direct interaction with
+  developers and the community)
+- [Issue tracker](https://code.castopod.org/adaures/castopod/-/issues) (for
+  feature requests & bug reports)
+
+Alternatively, you can follow us on social media platforms to get news about
+Castopod:
+
+- [podlibre.social](https://podlibre.social/@Castopod) (Mastodon instance)
+- [Twitter](https://twitter.com/castopod)
+- [LinkedIn](https://linkedin.com/company/castopod)
+- [Facebook](https://www.facebook.com/castopod)
+
+## Sponsors
+
+The ongoing development of Castopod is made possible with the support of its
+backers. If you'd like to help, please consider
+[sponsoring Castopod's development](https://opencollective.com/castopod/contribute).
+
+[![Ad Aures Logo](../../../assets/images/sponsors/adaures.svg)](https://adaures.com/)
+
+[![NLnet Logo](../../../assets/images/sponsors/nlnet.svg)](https://nlnet.nl/)
+
+## License
+
+[GNU Affero General Public License v3.0](https://choosealicense.com/licenses/agpl-3.0/)
+
+Copyright © 2020-present, [Ad Aures](https://adaures.com/).
--- a/docs/src/de/getting-started/auth.md
+++ b/docs/src/de/getting-started/auth.md
 ---
 title: Authentication & Authorization
-sidebarDepth: 3
 ---

-# Authentication & Authorization
-
 Castopod handles authentication and authorization using `codeigniter/shield`
 coupled with custom rules. Roles and permissions are defined at two levels:

@@ -15,24 +12,25 @@ coupled with custom rules. Roles and permissions are defined at two levels:

 ### Instance roles

-<!-- AUTH-INSTANCE-ROLES-LIST:START - Do not remove or modify this section -->
+{/* AUTH-INSTANCE-ROLES-LIST:START - Do not remove or modify this section */}

-| role        | description                         | permissions                                                                                |
-| ----------- | ----------------------------------- | ------------------------------------------------------------------------------------------ |
-| Super admin | Has complete control over Castopod. | admin.\*, podcasts.\*, users.manage, persons.manage, pages.manage, fediverse.manage-blocks |
-| Manager     | Manages Castopod's content.         | podcasts.create, podcasts.import, persons.manage, pages.manage                             |
-| Podcaster   | General users of Castopod.          | admin.access                                                                               |
+| role        | description                         | permissions                                                                                            |
+| ----------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| Super admin | Has complete control over Castopod. | admin.\*, plugins.\*, podcasts.\*, users.manage, persons.manage, pages.manage, fediverse.manage-blocks |
+| Manager     | Manages Castopod's content.         | podcasts.create, podcasts.import, persons.manage, pages.manage                                         |
+| Podcaster   | General users of Castopod.          | admin.access                                                                                           |

-<!-- AUTH-INSTANCE-ROLES-LIST:END -->
+{/* AUTH-INSTANCE-ROLES-LIST:END */}

 ### Instance permissions

-<!-- AUTH-INSTANCE-PERMISSIONS-LIST:START - Do not remove or modify this section -->
+{/* AUTH-INSTANCE-PERMISSIONS-LIST:START - Do not remove or modify this section */}

 | permission              | description                                                        |
 | ----------------------- | ------------------------------------------------------------------ |
 | admin.access            | Can access the Castopod admin area.                                |
 | admin.settings          | Can access the Castopod settings.                                  |
+| plugins.manage          | Auth.instance_permissions.plugins.manage                           |
 | users.manage            | Can manage Castopod users.                                         |
 | persons.manage          | Can manage persons.                                                |
 | pages.manage            | Can manage pages.                                                  |
@@ -41,47 +39,47 @@ coupled with custom rules. Roles and permissions are defined at two levels:
 | podcasts.import         | Can import podcasts.                                               |
 | fediverse.manage-blocks | Can block fediverse actors/domains from interacting with Castopod. |

-<!-- AUTH-INSTANCE-PERMISSIONS-LIST:END -->
+{/* AUTH-INSTANCE-PERMISSIONS-LIST:END */}

 ## 2. Per podcast roles and permissions

 ### Per podcast roles

-<!-- AUTH-PODCAST-ROLES-LIST:START - Do not remove or modify this section -->
+{/* AUTH-PODCAST-ROLES-LIST:START - Do not remove or modify this section */}

-| role   | description                                               | permissions                                                                                                                                                                                                                                                                                          |
-| ------ | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Admin  | Has complete control of podcast #{id}.                    | \*                                                                                                                                                                                                                                                                                                   |
-| Editor | Manages content and publications of podcast #{id}.        | view, edit, manage-import, manage-persons, manage-platforms, manage-publications, interact-as, episodes.view, episodes.create, episodes.edit, episodes.delete, episodes.manage-persons, episodes.manage-clips, episodes.manage-publications, episodes.manage-comments, episodes.manage-notifications |
-| Author | Manages content of podcast #{id} but cannot publish them. | view, manage-persons, episodes.view, episodes.create, episodes.edit, episodes.manage-persons, episodes.manage-clips                                                                                                                                                                                  |
-| Guest  | General contributor of the podcast #{id}.                 | view, episodes.view                                                                                                                                                                                                                                                                                  |
+| role   | description                                                 | permissions                                                                                                                                                                                                                                                                                 |
+| ------ | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Admin  | Has complete control of podcast #\{id\}.                    | \*                                                                                                                                                                                                                                                                                          |
+| Editor | Manages content and publications of podcast #\{id\}.        | view, edit, manage-import, manage-persons, manage-platforms, manage-publications, manage-notifications, interact-as, episodes.view, episodes.create, episodes.edit, episodes.delete, episodes.manage-persons, episodes.manage-clips, episodes.manage-publications, episodes.manage-comments |
+| Author | Manages content of podcast #\{id\} but cannot publish them. | view, manage-persons, episodes.view, episodes.create, episodes.edit, episodes.manage-persons, episodes.manage-clips                                                                                                                                                                         |
+| Guest  | General contributor of the podcast #\{id\}.                 | view, episodes.view                                                                                                                                                                                                                                                                         |

-<!-- AUTH-PODCAST-ROLES-LIST:END -->
+{/* AUTH-PODCAST-ROLES-LIST:END */}

 ### Per podcast permissions

-<!-- AUTH-PODCAST-PERMISSIONS-LIST:START - Do not remove or modify this section -->
-
-| permission                   | description                                                              |
-| ---------------------------- | ------------------------------------------------------------------------ |
-| view                         | Can view dashboard and analytics of podcast #{id}.                       |
-| edit                         | Can edit podcast #{id}.                                                  |
-| delete                       | Can delete podcast #{id}.                                                |
-| manage-import                | Can synchronize imported podcast #{id}.                                  |
-| manage-persons               | Can manage subscriptions of podcast #{id}.                               |
-| manage-subscriptions         | Can manage subscriptions of podcast #{id}.                               |
-| manage-contributors          | Can manage contributors of podcast #{id}.                                |
-| manage-platforms             | Can set/remove platform links of podcast #{id}.                          |
-| manage-publications          | Can publish podcast #{id}.                                               |
-| manage-notifications         | Can view and mark notifications as read for podcast #{id}.               |
-| interact-as                  | Can interact as the podcast #{id} to favourite, share or reply to posts. |
-| episodes.view                | Can view dashboard and analytics of podcast #{id}.                       |
-| episodes.create              | Can create episodes for podcast #{id}.                                   |
-| episodes.edit                | Can edit podcast #{id}.                                                  |
-| episodes.delete              | Can delete podcast #{id}.                                                |
-| episodes.manage-persons      | Can manage subscriptions of podcast #{id}.                               |
-| episodes.manage-clips        | Can manage video clips or soundbites of podcast #{id}.                   |
-| episodes.manage-publications | Can publish podcast #{id}.                                               |
-| episodes.manage-comments     | Can create/remove episode comments of podcast #{id}.                     |
-
-<!-- AUTH-PODCAST-PERMISSIONS-LIST:END -->
+{/* AUTH-PODCAST-PERMISSIONS-LIST:START - Do not remove or modify this section */}
+
+| permission                   | description                                                                |
+| ---------------------------- | -------------------------------------------------------------------------- |
+| view                         | Can view dashboard and analytics of podcast #\{id\}.                       |
+| edit                         | Can edit podcast #\{id\}.                                                  |
+| delete                       | Can delete podcast #\{id\}.                                                |
+| manage-import                | Can synchronize imported podcast #\{id\}.                                  |
+| manage-persons               | Can manage subscriptions of podcast #\{id\}.                               |
+| manage-subscriptions         | Can manage subscriptions of podcast #\{id\}.                               |
+| manage-contributors          | Can manage contributors of podcast #\{id\}.                                |
+| manage-platforms             | Can set/remove platform links of podcast #\{id\}.                          |
+| manage-publications          | Can publish podcast #\{id\}.                                               |
+| manage-notifications         | Can view and mark notifications as read for podcast #\{id\}.               |
+| interact-as                  | Can interact as the podcast #\{id\} to favourite, share or reply to posts. |
+| episodes.view                | Can view dashboards and analytics of podcast #\{id\}'s episodes.           |
+| episodes.create              | Can create episodes for podcast #\{id\}.                                   |
+| episodes.edit                | Can edit episodes of podcast #\{id\}.                                      |
+| episodes.delete              | Can delete episodes of podcast #\{id\}.                                    |
+| episodes.manage-persons      | Can manage episode persons of podcast #\{id\}.                             |
+| episodes.manage-clips        | Can manage video clips or soundbites of podcast #\{id\}.                   |
+| episodes.manage-publications | Can publish/unpublish episodes and posts of podcast #\{id\}.               |
+| episodes.manage-comments     | Can create/remove episode comments of podcast #\{id\}.                     |
+
+{/* AUTH-PODCAST-PERMISSIONS-LIST:END */}
--- a/docs/src/content/docs/fa/getting-started/docker.mdx
+++ b/docs/src/content/docs/fa/getting-started/docker.mdx
+---
+title: Official Docker images
+---
+
+Castopod pushes 3 Docker images to the Docker Hub during its automated build
+process:
+
+- [**`castopod/castopod`**](https://hub.docker.com/r/castopod/castopod): an all
+  in one castopod image using nginx unit
+- [**`castopod/app`**](https://hub.docker.com/r/castopod/app): the app bundle
+  with all of Castopod dependencies
+- [**`castopod/web-server`**](https://hub.docker.com/r/castopod/web-server): an
+  Nginx configuration for Castopod
+
+Additionally, Castopod requires a MySQL-compatible database. A Redis database
+can be added as a cache handler.
+
+## Supported tags
+
+- `develop` [unstable], latest development branch build
+- `beta` [stable], latest beta version build
+- `latest` [stable], latest version build
+- `1.x.x` [stable], specific version build (since `1.0.0`)
+
+## Example usage
+
+1. Install [docker](https://docs.docker.com/get-docker/) and
+   [docker-compose](https://docs.docker.com/compose/install/)
+
+2. Create a `docker-compose.yml` file with the following:
+
+   ```yml
+   version: "3.7"
+
+   services:
+     app:
+       image: castopod/castopod:latest
+       container_name: "castopod-app"
+       volumes:
+         - castopod-media:/var/www/castopod/public/media
+       environment:
+         MYSQL_DATABASE: castopod
+         MYSQL_USER: castopod
+         MYSQL_PASSWORD: changeme
+         CP_BASEURL: "https://castopod.example.com"
+         CP_ANALYTICS_SALT: changeme
+         CP_CACHE_HANDLER: redis
+         CP_REDIS_HOST: redis
+         CP_REDIS_PASSWORD: changeme
+       networks:
+         - castopod-app
+         - castopod-db
+       ports:
+         - 8000:8000
+       restart: unless-stopped
+
+     mariadb:
+       image: mariadb:10.5
+       container_name: "castopod-mariadb"
+       networks:
+         - castopod-db
+       volumes:
+         - castopod-db:/var/lib/mysql
+       environment:
+         MYSQL_ROOT_PASSWORD: changeme
+         MYSQL_DATABASE: castopod
+         MYSQL_USER: castopod
+         MYSQL_PASSWORD: changeme
+       restart: unless-stopped
+
+     redis:
+       image: redis:7.0-alpine
+       container_name: "castopod-redis"
+       command: --requirepass changeme
+       volumes:
+         - castopod-cache:/data
+       networks:
+         - castopod-app
+
+   volumes:
+     castopod-media:
+     castopod-db:
+     castopod-cache:
+
+   networks:
+     castopod-app:
+     castopod-db:
+   ```
+
+   You have to adapt some variables to your needs (e.g. `CP_BASEURL`,
+   `MYSQL_ROOT_PASSWORD`, `MYSQL_PASSWORD` and `CP_ANALYTICS_SALT`).
+
+3. Setup a reverse proxy for TLS (SSL/HTTPS)
+
+   TLS is mandatory for ActivityPub to work. This job can easily be handled by a
+   reverse proxy, for example with [Caddy](https://caddyserver.com/):
+
+   ```
+   #castopod
+   castopod.example.com {
+       reverse_proxy localhost:8000
+   }
+   ```
+
+4. Run `docker-compose up -d`, wait for it to initialize and head on to
+   `https://castopod.example.com/cp-install` to finish setting up Castopod!
+
+5. You're all set, start podcasting! 🎙️🚀
+
+## Environment Variables
+
+- **castopod/castopod** and **castopod/app**
+
+  | Variable name                         | Type (`default`)        | Default          |
+  | ------------------------------------- | ----------------------- | ---------------- |
+  | **`CP_BASEURL`**                      | string                  | `undefined`      |
+  | **`CP_MEDIA_BASEURL`**                | ?string                 | `CP_BASEURL`     |
+  | **`CP_ADMIN_GATEWAY`**                | ?string                 | `"cp-admin"`     |
+  | **`CP_AUTH_GATEWAY`**                 | ?string                 | `"cp-auth"`      |
+  | **`CP_ANALYTICS_SALT`**               | string                  | `undefined`      |
+  | **`CP_DATABASE_HOSTNAME`**            | ?string                 | `"mariadb"`      |
+  | **`CP_DATABASE_NAME`**                | ?string                 | `MYSQL_DATABASE` |
+  | **`CP_DATABASE_USERNAME`**            | ?string                 | `MYSQL_USER`     |
+  | **`CP_DATABASE_PASSWORD`**            | ?string                 | `MYSQL_PASSWORD` |
+  | **`CP_DATABASE_PREFIX`**              | ?string                 | `"cp_"`          |
+  | **`CP_CACHE_HANDLER`**                | [`"file"` or `"redis"`] | `"file"`         |
+  | **`CP_REDIS_HOST`**                   | ?string                 | `"localhost"`    |
+  | **`CP_REDIS_PASSWORD`**               | ?string                 | `null`           |
+  | **`CP_REDIS_PORT`**                   | ?number                 | `6379`           |
+  | **`CP_REDIS_DATABASE`**               | ?number                 | `0`              |
+  | **`CP_EMAIL_SMTP_HOST`**              | ?string                 | `undefined`      |
+  | **`CP_EMAIL_FROM`**                   | ?string                 | `undefined`      |
+  | **`CP_EMAIL_SMTP_USERNAME`**          | ?string                 | `"localhost"`    |
+  | **`CP_EMAIL_SMTP_PASSWORD`**          | ?string                 | `null`           |
+  | **`CP_EMAIL_SMTP_PORT`**              | ?number                 | `25`             |
+  | **`CP_EMAIL_SMTP_CRYPTO`**            | [`"tls"` or `"ssl"`]    | `"tls"`          |
+  | **`CP_ENABLE_2FA`**                   | ?boolean                | `undefined`      |
+  | **`CP_MEDIA_FILE_MANAGER`**           | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_ENDPOINT`**            | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_KEY`**                 | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_SECRET`**              | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_REGION`**              | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_BUCKET`**              | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_PROTOCOL`**            | ?number                 | `undefined`      |
+  | **`CP_MEDIA_S3_PATH_STYLE_ENDPOINT`** | ?boolean                | `undefined`      |
+  | **`CP_MEDIA_S3_KEY_PREFIX`**          | ?string                 | `undefined`      |
+  | **`CP_DISABLE_HTTPS`**                | ?[`0` or `1`]           | `undefined`      |
+  | **`CP_MAX_BODY_SIZE`**                | ?number (with suffix)   | `512M`           |
+  | **`CP_PHP_MEMORY_LIMIT`**             | ?number (with suffix)   | `512M`           |
+  | **`CP_TIMEOUT`**                      | ?number                 | `900`            |
+
+- **castopod/web-server**
+
+  | Variable name          | Type                  | Default |
+  | ---------------------- | --------------------- | ------- |
+  | **`CP_APP_HOSTNAME`**  | ?string               | `"app"` |
+  | **`CP_MAX_BODY_SIZE`** | ?number (with suffix) | `512M`  |
+  | **`CP_TIMEOUT`**       | ?number               | `900`   |
--- a/docs/src/content/docs/fa/getting-started/install.mdx
+++ b/docs/src/content/docs/fa/getting-started/install.mdx
+---
+title: How to install Castopod?
+---
+
+import { Aside } from "@astrojs/starlight/components";
+
+Castopod was thought-out to be easy to install. Whether using dedicated or
+shared hosting, you can install it on most PHP-MySQL compatible web servers.
+
+## Requirements
+
+- PHP v8.4 or higher
+- MySQL version 8.4 or higher or MariaDB version 11.4 or higher
+- HTTPS support
+- An [ntp-synced clock](https://wiki.debian.org/NTP) to validate federation's
+  incoming requests
+
+### PHP v8.4 or higher
+
+PHP version 8.4 or higher is required, with the following extensions installed:
+
+- [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) with **JPEG**,
+  **PNG** and **WEBP** libraries.
+- [exif](https://www.php.net/manual/en/exif.installation.php)
+
+Additionally, make sure that the following extensions are enabled in your PHP:
+
+- json (enabled by default - don't turn it off)
+- xml (enabled by default - don't turn it off)
+- [mysqlnd](https://php.net/manual/en/mysqlnd.install.php)
+
+### MySQL compatible database
+
+> We recommend using [MariaDB](https://mariadb.org).
+
+You will need the server hostname, database name, username and password to
+complete the installation process. If you do not have these, please contact your
+server administrator.
+
+#### Privileges
+
+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`.
+
+### (Optional) FFmpeg v4.1.8 or higher for Video Clips
+
+[FFmpeg](https://www.ffmpeg.org/) version 4.1.8 or higher is required if you
+want to generate Video Clips. The following extensions must be installed:
+
+- **FreeType 2** library for
+  [gd](https://www.php.net/manual/en/image.installation.php).
+
+### (Optional) Other recommendations
+
+- Redis for better cache performances.
+- CDN for static files caching and better performances.
+- e-mail gateway for lost passwords.
+
+## Install instructions
+
+### Pre-requisites
+
+0. Get a Web Server with [requirements](#requirements) installed
+1. Create a MySQL database for Castopod with a user having access and
+   modification privileges (for more info, see
+   [MySQL compatible database](#mysql-compatible-database)).
+2. Activate HTTPS on your domain with an _SSL certificate_.
+3. Download and unzip the latest [Castopod Package](https://castopod.org/) onto
+   the web server if you haven’t already.
+   - ⚠️ Set the web server document root to the `public/` sub-folder within the
+     `castopod` folder.
+4. Add **cron tasks** on your web server for various background processes
+   (replace the paths accordingly):
+
+   ```bash
+      * * * * * /path/to/php /path/to/castopod/spark tasks:run >> /dev/null 2>&1
+   ```
+
+   **Note** - If you do not add this cron task, the following Castopod features
+   will not work:
+
+   - Importing a podcast from an existing RSS feed
+   - Broadcasting social activities to your followers in the fediverse
+   - Broadcasting episodes to open hubs using
+     [WebSub](https://en.wikipedia.org/wiki/WebSub)
+   - Generating video clips -
+     [requires FFmpeg](#optional-ffmpeg-v418-or-higher-for-video-clips)
+
+### (recommended) Install Wizard
+
+1. Run the Castopod install script by going to the install wizard page
+   (`https://your_domain_name.com/cp-install`) in your favorite web browser.
+2. Follow the instructions on your screen.
+3. Start podcasting!
+
+<Aside>
+
+The install script writes a `.env` file in the package root. If you cannot go
+through the install wizard, you can create and edit the `.env` file manually
+based on the `.env.example` file.
+
+</Aside>
+
+### Using CLI
+
+1. Create a `.env` file in the package root based on the `.env.example` file.
+
+2. Initialize the database using:
+
+   ```sh
+   php spark install:init-database
+   ```
+
+3. Create the superadmin user using:
+
+   ```sh
+   php spark install:create-superadmin
+   ```
+
+4. Head on to your admin gateway to start podcasting!
+
+### 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:
+
+```ini
+# […]
+
+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"`      |
+
+### Media storage
+
+By default, files are saved to the `public/media` folder using the file system.
+If you need to relocate the `media` folder to a different location, you can
+specify it in your `.env` file as shown below:
+
+```ini
+# […]
+
+media.root="media"
+media.storage="/mnt/storage"
+```
+
+In this example, the files will be saved to the /mnt/storage/media folder. Make
+sure to also update your web server configuration to reflect this change.
+
+### S3
+
+If you prefer storing your media files on an S3 compatible storage, you may
+specify it in your `.env`:
+
+```ini
+# […]
+
+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` |
+| **`pathStyleEndpoint`** | boolean | `false`     |
+| **`keyPrefix`**         | string  | `undefined` |
+
+## Community packages
+
+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](https://yunohost.org/) 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.
+
+<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="Install Castopod with 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>
+  Github Repo
+</a>
+
+</div>
--- a/docs/src/content/docs/fa/getting-started/security.mdx
+++ b/docs/src/content/docs/fa/getting-started/security.mdx
+---
+title: Ar surentez
+---
+
+Castopod is built on top of [CodeIgniter4](https://codeigniter.com/), a PHP
+framework that encourages
+[good security practices](https://codeigniter.com/user_guide/concepts/security.html).
+
+To maximize your instance's safety and prevent any malicious attack, we
+recommend you update all your Castopod files permissions after installation or
+updates (to avoid any prior permission error):
+
+- `writable/` folder must be **readable** and **writable**.
+- `public/media/` folder must be **readable** and **writable**.
+- any other file must be set to **readonly**.
+
+For instance, if you are using Apache or NGINX with Ubuntu you may do the
+following:
+
+```bash
+sudo chown -R root:root /path/to/castopod
+sudo chown -R www-data:www-data /path/to/castopod/writable
+sudo chown -R www-data:www-data /path/to/castopod/public/media
+```
--- a/docs/src/fa/getting-started/update.md
+++ b/docs/src/fa/getting-started/update.md
 ---
-title: Update
-sidebarDepth: 3
+title: How to update Castopod?
 ---

-# How to update Castopod?
+import { Aside } from "@astrojs/starlight/components";

 After installing Castopod, you may want to update your instance to the latest
 version in order to enjoy the latest features ✨, bug fixes 🐛 and performance
@@ -36,12 +35,12 @@ improvements ⚡.
   - Remove all files except `.env` and `public/media`
   - Copy the new files from the downloaded package into your server

-     ::: info Note
+     <Aside>

     You may need to reset files permissions as during the install process.
     Check [Security Concerns](./security.md).

-     :::
+     </Aside>

 4. Update your database schema from your `Castopod Admin` > `About` page or by
   running:
@@ -52,9 +51,10 @@ improvements ⚡.

 5. Clear your cache from your `Castopod Admin` > `Settings` > `general` >
   `Housekeeping`
+
 6. ✨ Enjoy your fresh instance, you're all done!

-::: info Note
+<Aside>

 Releases may come with additional update instructions (see
 [releases page](https://code.castopod.org/adaures/castopod/-/releases)).
@@ -62,7 +62,7 @@ Releases may come with additional update instructions (see
 - cf.
  [I haven't updated my instance in a long time… What should I do?](#i-havent-updated-my-instance-in-a-long-time-what-should-i-do)

-:::
+</Aside>

 ## Fully Automated updates


--- a/docs/src/content/docs/fa/index.mdx
+++ b/docs/src/content/docs/fa/index.mdx
+---
+title: Welcome 👋
+---
+
+import { LinkCard } from "@astrojs/starlight/components";
+
+Castopod is a free & open-source hosting platform made for podcasters who want
+engage and interact with their audience.
+
+Castopod is easy to install and was built on top of
+[CodeIgniter4](https://codeigniter.com/), a powerful PHP framework with a very
+small footprint.
+
+<LinkCard title="Install" href="./getting-started/install" />
+
+## Features
+
+- 🌱  Free & open-source (AGPL v3 License)
+- 🔐  Focused on data sovereignty: your content, audience, and analytics belong
+  to you, and you only
+- 🪄  Podcasting 2.0 features: GUID, locked, transcripts, funding, chapters,
+  location, persons, soundbites, …
+- 💬  Built-in social network:
+  - 🚀  Castopod is part of the Fediverse, a decentralized social network
+  - ❤️  Create posts, share, favourite, and comment on episodes
+- 📈  Built-in analytics:
+  - ⚖️  GDPR / CCPA / LGPD compliant
+  - 🪙  Standard IABv2 audience measurement
+  - 🏡  On-premises analytics, no third party involved
+- 📢  Built-in marketing tools:
+  - ✅  SEO ready (open-graph meta-tags, JSON-LD, …)
+  - 📱  PWA: install as a standalone app
+  - 🎨  Customizable theme colors
+  - 🎬  Generate ready-to-share Video clips from episodes
+  - 🔉  Generate soundbites
+  - ▶️  Embeddable player, embed your episodes on any website
+- 💸  Monetization:
+  - 🔗  Funding links
+  - 📲  listen-to-click ads
+  - 🤝  value4value / WebMonetization
+  - 💎  Premium podcasts
+- 📡  Publish your episodes everywhere with RSS:
+  - 📱  On all indexes and apps: Podcast Index, Apple Podcasts, Spotify, Google
+    Podcasts, Deezer, Podcast Addict, Podfriend, …
+  - ⚡  Broadcast your episodes instantly with WebSub
+- 📥  Podcast import: move your existing podcast into Castopod
+- 📤  Move your podcast out of Castopod
+- 🔀  Multi-tenant: host as many podcasts as you want
+- 👥  Multi-user: add contributors and set roles
+- 🌎  i18n support: translated in English, French, Polish, German, Brazilian
+  Portuguese, Spanish, simplified Chinese… and
+  [many more](https://translate.castopod.org)!
+
+## Motivation
+
+The podcasting ecosystem is decentralized by nature: you can create your podcast
+as an RSS file, publish it on the web and have it shared everywhere online.
+
+It is in fact one of the only media to have stayed this way for a long time.
+
+As usages are evolving, more and more people are getting into podcasts: whether
+it is creators finding new ways to share their ideas, or listeners in the search
+for better content.
+
+With podcasting becoming more widely used, some companies are trying to shift it
+towards a more controlled and centralized medium.
+
+Castopod was created in an effort to provide an open and sustainable alternative
+to hosting your podcasts, promoting decentralization to ensure that podcasters
+creativity can express itself.
+
+This project is pushed by the open-source community, and specifically by the
+[Fediverse](https://fediverse.party/en/fediverse/) and
+[Podcasting 2.0](https://podcastindex.org/) movements.
+
+## Comparison with other solutions
+
+We believe that a solution is not necessarily right for everyone, it highly
+depends on your needs. So, here are comparisons with other tools to help you to
+gauge whether Castopod is the right fit for you.
+
+### Castopod vs Wordpress
+
+Castopod is often referred to as "the Wordpress for podcasts" because of the
+similarities between the two. In some ways this is true. And actually, Castopod
+was greatly inspired by the Wordpress ecosystem, seeing the ease of adoption
+from the community and the number of websites running it.
+
+Just like Wordpress, Castopod is free & open source, built using PHP with a
+MySQL database and is packaged in a way that you can easily install on most web
+servers.
+
+Wordpress is a great way to create your website and extend it with plugins to
+get what you want. It is a full fledged CMS that helps you get any type of
+website online.
+
+On the other hand, Castopod is meant to address the podcasters needs
+specifically, focusing on podcasting, and nothing else. You don't need any
+plugin to get you started on your podcasting journey.
+
+This allows optimizing the processes specific to podcasting: ranging from the
+creation of your podcasts and the publication of new episodes all the way to
+broadcasting, marketing and analytics.
+
+Finally, depending on your needs, Wordpress and Castopod can even live side by
+side as they share the same requirements!
+
+### Castopod vs Funkwhale
+
+Funkwhale is a self-hosted, modern free and open-source music server. Just as
+Castopod, Funkwhale is on the fediverse, a decentralized social network allowing
+interoperability between the two.
+
+Funkwhale was initially built around music. And later on, as the project
+evolved, the ability to host podcasts was introduced.
+
+Unlike Funkwhale, Castopod has been designed and built around podcasting
+exclusively. This allows easier implementation for features related to the
+podcasting ecosystem, such as the podcasting 2.0 features (transcripts,
+chapters, locations, persons, …).
+
+So, you should probably use Funkwhale if you want to host your music, and use
+Castopod if you want to host your podcasts.
+
+### Castopod vs other podcast hosts
+
+There are many solutions for you to host your podcasts, some of which are really
+great and [a lot of them](https://podcastindex.org/apps) are jumping into the
+Podcasting 2.0 wagon just like Castopod!
+
+Each of these solutions differ from one another, you may compare with the
+[list of features](#features).
+
+That being said, there are two main differences with other podcasting solutions:
+
+- Castopod can be self-hosted and is the only solution that allows you to keep
+  full control over what you produce. Also, as it is open-source, you can even
+  customize it as you wish.
+
+- Castopod is the only solution that currently integrates both a decentralized
+  social network with ActivityPub as well as many of the podcasting 2.0
+  features, hoping to bridge the gap between the two.
+
+## Contributing
+
+Love Castopod and would like to help? Take a look at the following documentation
+to get you started.
+
+### Code of conduct
+
+Castopod has adopted a Code of Conduct that we expect project participants to
+adhere to. Please read the
+[CODE_OF_CONDUCT manual](https://code.castopod.org/adaures/castopod/-/blob/beta/CODE_OF_CONDUCT.md)
+so that you can understand what actions will and will not be tolerated.
+
+### Contributing guide
+
+Read our [contributing guide](../contributing/guidelines.md) to learn about our
+development process, how to propose bugfixes and improvements, and how to build
+and test your changes to Castopod.
+
+## Contact
+
+You may reach us for help or ask any question you have on:
+
+- [Discord](https://castopod.org/discord) (for direct interaction with
+  developers and the community)
+- [Issue tracker](https://code.castopod.org/adaures/castopod/-/issues) (for
+  feature requests & bug reports)
+
+Alternatively, you can follow us on social media platforms to get news about
+Castopod:
+
+- [podlibre.social](https://podlibre.social/@Castopod) (Mastodon instance)
+- [Twitter](https://twitter.com/castopod)
+- [LinkedIn](https://linkedin.com/company/castopod)
+- [Facebook](https://www.facebook.com/castopod)
+
+## Sponsors
+
+The ongoing development of Castopod is made possible with the support of its
+backers. If you'd like to help, please consider
+[sponsoring Castopod's development](https://opencollective.com/castopod/contribute).
+
+[![Ad Aures Logo](../../../assets/images/sponsors/adaures.svg)](https://adaures.com/)
+
+[![NLnet Logo](../../../assets/images/sponsors/nlnet.svg)](https://nlnet.nl/)
+
+## License
+
+[GNU Affero General Public License v3.0](https://choosealicense.com/licenses/agpl-3.0/)
+
+Copyright © 2020-present, [Ad Aures](https://adaures.com/).
--- a/docs/src/ar/getting-started/auth.md
+++ b/docs/src/ar/getting-started/auth.md
 ---
 title: Authentication & Authorization
-sidebarDepth: 3
 ---

-# Authentication & Authorization
-
 Castopod handles authentication and authorization using `codeigniter/shield`
 coupled with custom rules. Roles and permissions are defined at two levels:

@@ -15,24 +12,25 @@ coupled with custom rules. Roles and permissions are defined at two levels:

 ### Instance roles

-<!-- AUTH-INSTANCE-ROLES-LIST:START - Do not remove or modify this section -->
+{/* AUTH-INSTANCE-ROLES-LIST:START - Do not remove or modify this section */}

-| role        | description                         | permissions                                                                                |
-| ----------- | ----------------------------------- | ------------------------------------------------------------------------------------------ |
-| Super admin | Has complete control over Castopod. | admin.\*, podcasts.\*, users.manage, persons.manage, pages.manage, fediverse.manage-blocks |
-| Manager     | Manages Castopod's content.         | podcasts.create, podcasts.import, persons.manage, pages.manage                             |
-| Podcaster   | General users of Castopod.          | admin.access                                                                               |
+| role        | description                         | permissions                                                                                            |
+| ----------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| Super admin | Has complete control over Castopod. | admin.\*, plugins.\*, podcasts.\*, users.manage, persons.manage, pages.manage, fediverse.manage-blocks |
+| Manager     | Manages Castopod's content.         | podcasts.create, podcasts.import, persons.manage, pages.manage                                         |
+| Podcaster   | General users of Castopod.          | admin.access                                                                                           |

-<!-- AUTH-INSTANCE-ROLES-LIST:END -->
+{/* AUTH-INSTANCE-ROLES-LIST:END */}

 ### Instance permissions

-<!-- AUTH-INSTANCE-PERMISSIONS-LIST:START - Do not remove or modify this section -->
+{/* AUTH-INSTANCE-PERMISSIONS-LIST:START - Do not remove or modify this section */}

 | permission              | description                                                        |
 | ----------------------- | ------------------------------------------------------------------ |
 | admin.access            | Can access the Castopod admin area.                                |
 | admin.settings          | Can access the Castopod settings.                                  |
+| plugins.manage          | Auth.instance_permissions.plugins.manage                           |
 | users.manage            | Can manage Castopod users.                                         |
 | persons.manage          | Can manage persons.                                                |
 | pages.manage            | Can manage pages.                                                  |
@@ -41,47 +39,47 @@ coupled with custom rules. Roles and permissions are defined at two levels:
 | podcasts.import         | Can import podcasts.                                               |
 | fediverse.manage-blocks | Can block fediverse actors/domains from interacting with Castopod. |

-<!-- AUTH-INSTANCE-PERMISSIONS-LIST:END -->
+{/* AUTH-INSTANCE-PERMISSIONS-LIST:END */}

 ## 2. Per podcast roles and permissions

 ### Per podcast roles

-<!-- AUTH-PODCAST-ROLES-LIST:START - Do not remove or modify this section -->
+{/* AUTH-PODCAST-ROLES-LIST:START - Do not remove or modify this section */}

-| role   | description                                               | permissions                                                                                                                                                                                                                                                                                          |
-| ------ | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Admin  | Has complete control of podcast #{id}.                    | \*                                                                                                                                                                                                                                                                                                   |
-| Editor | Manages content and publications of podcast #{id}.        | view, edit, manage-import, manage-persons, manage-platforms, manage-publications, interact-as, episodes.view, episodes.create, episodes.edit, episodes.delete, episodes.manage-persons, episodes.manage-clips, episodes.manage-publications, episodes.manage-comments, episodes.manage-notifications |
-| Author | Manages content of podcast #{id} but cannot publish them. | view, manage-persons, episodes.view, episodes.create, episodes.edit, episodes.manage-persons, episodes.manage-clips                                                                                                                                                                                  |
-| Guest  | General contributor of the podcast #{id}.                 | view, episodes.view                                                                                                                                                                                                                                                                                  |
+| role   | description                                                 | permissions                                                                                                                                                                                                                                                                                 |
+| ------ | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Admin  | Has complete control of podcast #\{id\}.                    | \*                                                                                                                                                                                                                                                                                          |
+| Editor | Manages content and publications of podcast #\{id\}.        | view, edit, manage-import, manage-persons, manage-platforms, manage-publications, manage-notifications, interact-as, episodes.view, episodes.create, episodes.edit, episodes.delete, episodes.manage-persons, episodes.manage-clips, episodes.manage-publications, episodes.manage-comments |
+| Author | Manages content of podcast #\{id\} but cannot publish them. | view, manage-persons, episodes.view, episodes.create, episodes.edit, episodes.manage-persons, episodes.manage-clips                                                                                                                                                                         |
+| Guest  | General contributor of the podcast #\{id\}.                 | view, episodes.view                                                                                                                                                                                                                                                                         |

-<!-- AUTH-PODCAST-ROLES-LIST:END -->
+{/* AUTH-PODCAST-ROLES-LIST:END */}

 ### Per podcast permissions

-<!-- AUTH-PODCAST-PERMISSIONS-LIST:START - Do not remove or modify this section -->
-
-| permission                   | description                                                              |
-| ---------------------------- | ------------------------------------------------------------------------ |
-| view                         | Can view dashboard and analytics of podcast #{id}.                       |
-| edit                         | Can edit podcast #{id}.                                                  |
-| delete                       | Can delete podcast #{id}.                                                |
-| manage-import                | Can synchronize imported podcast #{id}.                                  |
-| manage-persons               | Can manage subscriptions of podcast #{id}.                               |
-| manage-subscriptions         | Can manage subscriptions of podcast #{id}.                               |
-| manage-contributors          | Can manage contributors of podcast #{id}.                                |
-| manage-platforms             | Can set/remove platform links of podcast #{id}.                          |
-| manage-publications          | Can publish podcast #{id}.                                               |
-| manage-notifications         | Can view and mark notifications as read for podcast #{id}.               |
-| interact-as                  | Can interact as the podcast #{id} to favourite, share or reply to posts. |
-| episodes.view                | Can view dashboard and analytics of podcast #{id}.                       |
-| episodes.create              | Can create episodes for podcast #{id}.                                   |
-| episodes.edit                | Can edit podcast #{id}.                                                  |
-| episodes.delete              | Can delete podcast #{id}.                                                |
-| episodes.manage-persons      | Can manage subscriptions of podcast #{id}.                               |
-| episodes.manage-clips        | Can manage video clips or soundbites of podcast #{id}.                   |
-| episodes.manage-publications | Can publish podcast #{id}.                                               |
-| episodes.manage-comments     | Can create/remove episode comments of podcast #{id}.                     |
-
-<!-- AUTH-PODCAST-PERMISSIONS-LIST:END -->
+{/* AUTH-PODCAST-PERMISSIONS-LIST:START - Do not remove or modify this section */}
+
+| permission                   | description                                                                |
+| ---------------------------- | -------------------------------------------------------------------------- |
+| view                         | Can view dashboard and analytics of podcast #\{id\}.                       |
+| edit                         | Can edit podcast #\{id\}.                                                  |
+| delete                       | Can delete podcast #\{id\}.                                                |
+| manage-import                | Can synchronize imported podcast #\{id\}.                                  |
+| manage-persons               | Can manage subscriptions of podcast #\{id\}.                               |
+| manage-subscriptions         | Can manage subscriptions of podcast #\{id\}.                               |
+| manage-contributors          | Can manage contributors of podcast #\{id\}.                                |
+| manage-platforms             | Can set/remove platform links of podcast #\{id\}.                          |
+| manage-publications          | Can publish podcast #\{id\}.                                               |
+| manage-notifications         | Can view and mark notifications as read for podcast #\{id\}.               |
+| interact-as                  | Can interact as the podcast #\{id\} to favourite, share or reply to posts. |
+| episodes.view                | Can view dashboards and analytics of podcast #\{id\}'s episodes.           |
+| episodes.create              | Can create episodes for podcast #\{id\}.                                   |
+| episodes.edit                | Can edit episodes of podcast #\{id\}.                                      |
+| episodes.delete              | Can delete episodes of podcast #\{id\}.                                    |
+| episodes.manage-persons      | Can manage episode persons of podcast #\{id\}.                             |
+| episodes.manage-clips        | Can manage video clips or soundbites of podcast #\{id\}.                   |
+| episodes.manage-publications | Can publish/unpublish episodes and posts of podcast #\{id\}.               |
+| episodes.manage-comments     | Can create/remove episode comments of podcast #\{id\}.                     |
+
+{/* AUTH-PODCAST-PERMISSIONS-LIST:END */}
--- a/docs/src/content/docs/fr-ca/getting-started/docker.mdx
+++ b/docs/src/content/docs/fr-ca/getting-started/docker.mdx
+---
+title: Official Docker images
+---
+
+Castopod pushes 3 Docker images to the Docker Hub during its automated build
+process:
+
+- [**`castopod/castopod`**](https://hub.docker.com/r/castopod/castopod): an all
+  in one castopod image using nginx unit
+- [**`castopod/app`**](https://hub.docker.com/r/castopod/app): the app bundle
+  with all of Castopod dependencies
+- [**`castopod/web-server`**](https://hub.docker.com/r/castopod/web-server): an
+  Nginx configuration for Castopod
+
+Additionally, Castopod requires a MySQL-compatible database. A Redis database
+can be added as a cache handler.
+
+## Supported tags
+
+- `develop` [unstable], latest development branch build
+- `beta` [stable], latest beta version build
+- `latest` [stable], latest version build
+- `1.x.x` [stable], specific version build (since `1.0.0`)
+
+## Example usage
+
+1. Install [docker](https://docs.docker.com/get-docker/) and
+   [docker-compose](https://docs.docker.com/compose/install/)
+
+2. Create a `docker-compose.yml` file with the following:
+
+   ```yml
+   version: "3.7"
+
+   services:
+     castopod:
+       image: castopod/castopod:latest
+       container_name: "castopod"
+       volumes:
+         - castopod-media:/var/www/castopod/public/media
+       environment:
+         MYSQL_DATABASE: castopod
+         MYSQL_USER: castopod
+         MYSQL_PASSWORD: changeme
+         CP_BASEURL: "https://castopod.example.com"
+         CP_ANALYTICS_SALT: changeme
+         CP_CACHE_HANDLER: redis
+         CP_REDIS_HOST: redis
+         CP_REDIS_PASSWORD: changeme
+       networks:
+         - castopod
+         - castopod-db
+       ports:
+         - 8000:8000
+       restart: unless-stopped
+
+     mariadb:
+       image: mariadb:11.2
+       container_name: "castopod-mariadb"
+       networks:
+         - castopod-db
+       volumes:
+         - castopod-db:/var/lib/mysql
+       environment:
+         MYSQL_ROOT_PASSWORD: changeme
+         MYSQL_DATABASE: castopod
+         MYSQL_USER: castopod
+         MYSQL_PASSWORD: changeme
+       restart: unless-stopped
+
+     redis:
+       image: redis:7.2-alpine
+       container_name: "castopod-redis"
+       command: --requirepass changeme
+       volumes:
+         - castopod-cache:/data
+       networks:
+         - castopod
+
+   volumes:
+     castopod-media:
+     castopod-db:
+     castopod-cache:
+
+   networks:
+     castopod:
+     castopod-db:
+   ```
+
+   You have to adapt some variables to your needs (e.g. `CP_BASEURL`,
+   `MYSQL_ROOT_PASSWORD`, `MYSQL_PASSWORD` and `CP_ANALYTICS_SALT`).
+
+3. Setup a reverse proxy for TLS (SSL/HTTPS)
+
+   TLS is mandatory for ActivityPub to work. This job can easily be handled by a
+   reverse proxy, for example with [Caddy](https://caddyserver.com/):
+
+   ```
+   #castopod
+   castopod.example.com {
+   	reverse_proxy localhost:8000
+   }
+   ```
+
+4. Run `docker-compose up -d`, wait for it to initialize and head on to
+   `https://castopod.example.com/cp-install` to finish setting up Castopod!
+
+5. You're all set, start podcasting! 🎙️🚀
+
+## Environment Variables
+
+- **castopod/castopod** and **castopod/app**
+
+  | Variable name                         | Type (`default`)        | Default          |
+  | ------------------------------------- | ----------------------- | ---------------- |
+  | **`CP_BASEURL`**                      | string                  | `undefined`      |
+  | **`CP_MEDIA_BASEURL`**                | ?string                 | `CP_BASEURL`     |
+  | **`CP_ADMIN_GATEWAY`**                | ?string                 | `"cp-admin"`     |
+  | **`CP_AUTH_GATEWAY`**                 | ?string                 | `"cp-auth"`      |
+  | **`CP_ANALYTICS_SALT`**               | string                  | `undefined`      |
+  | **`CP_DATABASE_HOSTNAME`**            | ?string                 | `"mariadb"`      |
+  | **`CP_DATABASE_NAME`**                | ?string                 | `MYSQL_DATABASE` |
+  | **`CP_DATABASE_USERNAME`**            | ?string                 | `MYSQL_USER`     |
+  | **`CP_DATABASE_PASSWORD`**            | ?string                 | `MYSQL_PASSWORD` |
+  | **`CP_DATABASE_PREFIX`**              | ?string                 | `"cp_"`          |
+  | **`CP_CACHE_HANDLER`**                | [`"file"` or `"redis"`] | `"file"`         |
+  | **`CP_REDIS_HOST`**                   | ?string                 | `"localhost"`    |
+  | **`CP_REDIS_PASSWORD`**               | ?string                 | `null`           |
+  | **`CP_REDIS_PORT`**                   | ?number                 | `6379`           |
+  | **`CP_REDIS_DATABASE`**               | ?number                 | `0`              |
+  | **`CP_EMAIL_SMTP_HOST`**              | ?string                 | `undefined`      |
+  | **`CP_EMAIL_FROM`**                   | ?string                 | `undefined`      |
+  | **`CP_EMAIL_SMTP_USERNAME`**          | ?string                 | `"localhost"`    |
+  | **`CP_EMAIL_SMTP_PASSWORD`**          | ?string                 | `null`           |
+  | **`CP_EMAIL_SMTP_PORT`**              | ?number                 | `25`             |
+  | **`CP_EMAIL_SMTP_CRYPTO`**            | [`"tls"` or `"ssl"`]    | `"tls"`          |
+  | **`CP_ENABLE_2FA`**                   | ?boolean                | `undefined`      |
+  | **`CP_MEDIA_FILE_MANAGER`**           | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_ENDPOINT`**            | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_KEY`**                 | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_SECRET`**              | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_REGION`**              | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_BUCKET`**              | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_PROTOCOL`**            | ?number                 | `undefined`      |
+  | **`CP_MEDIA_S3_PATH_STYLE_ENDPOINT`** | ?boolean                | `undefined`      |
+  | **`CP_MEDIA_S3_KEY_PREFIX`**          | ?string                 | `undefined`      |
+  | **`CP_DISABLE_HTTPS`**                | ?[`0` or `1`]           | `undefined`      |
+  | **`CP_MAX_BODY_SIZE`**                | ?number (with suffix)   | `512M`           |
+  | **`CP_PHP_MEMORY_LIMIT`**             | ?number (with suffix)   | `512M`           |
+  | **`CP_TIMEOUT`**                      | ?number                 | `900`            |
+
+- **castopod/web-server**
+
+  | Variable name          | Type                  | Default |
+  | ---------------------- | --------------------- | ------- |
+  | **`CP_APP_HOSTNAME`**  | ?string               | `"app"` |
+  | **`CP_MAX_BODY_SIZE`** | ?number (with suffix) | `512M`  |
+  | **`CP_TIMEOUT`**       | ?number               | `900`   |
No results found