--- title: Instalação sidebarDepth: 3 --- # Como instalar o Castopod? Castopod foi pensado para ser fácil de instalar. Seja usando hospedagem dedicada ou compartilhada, você pode instalá-lo na maioria dos servidores web compatíveis com PHP-MySQL. ::: dica Nota Nós lançamos imagens Docker oficiais para Castopod! Se você prefere usar o Docker, você pode pular isso e ir direto para a [documentação docker](./docker.md) de Castopod. ::: ## Requisitos - PHP v8.1 ou superior - MySQL versão 5.7 ou superior ou MariaDB versão 10.2 ou superior - Suporte a HTTPS - An [ntp-synced clock](https://wiki.debian.org/NTP) to validate federation's incoming requests ### PHP v8.1 ou superior É necessário PHP versão 8.1 ou superior, com as seguintes extensões instaladas: - [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) com **JPEG**, **PNG** e bibliotecas **WEBP**. - [exif](https://www.php.net/manual/en/exif.installation.php) Além disso, certifique-se de que as seguintes extensões estejam habilitadas em seu PHP: - json (habilitado por padrão - não desativar) - xml (habilitado por padrão - não desativar) - [mysqlnd](https://php.net/manual/en/mysqlnd.install.php) ### Banco de dados compatível com MySQL > Recomendamos usar o [MariaDB](https://mariadb.org). ::: warning Aviso Castopod só funciona com bancos de dados MySQL 5.7 ou superior compatíveis. It will break with the previous MySQL v5.6 for example as its end of life was on February 5, 2021. ::: Você vai precisar do hostname do servidor, nome do banco de dados, nome do usuário e senha para concluir o processo de instalação. Se você não os tem, entre em contato com o administrador do servidor. #### Privilégios User must have at least these privileges on the database for Castopod to work: `CREATE`, `ALTER`, `DELETE`, `EXECUTE`, `INDEX`, `INSERT`, `SELECT`, `UPDATE`, `REFERENCES`, `CREATE VIEW`. ### (Opcional) FFmpeg v4.1.8 ou superior para Clipes de Vídeo [FFmpeg](https://www.ffmpeg.org/) version 4.1.8 or higher is required if you want to generate Video Clips. As seguintes extensões devem ser instaladas: - Biblioteca **FreeType 2** para [gd](https://www.php.net/manual/en/image.installation.php). ### (Opcional) Outras recomendações - Redis para melhores desempenhos de cache. - CDN para cache de arquivos estáticos e melhores desempenhos. - gateway de e-mail para senhas perdidas. ## Instruções de instalação ### Pré-requisitos 0. Obter um servidor web com os [requisitos](#requirements) instalados 1. Criar um banco de dados MySQL para Castopod com um usuário com privilégios de acesso e de modificação (para mais informações, ver o [banco de dados compatível com MySQL](#mysql-compatible-database)). 2. Ativar HTTPS em seu domínio com um _certificado SSL_. 3. Baixar e descompactar o último [Pacote Castopod](https://castopod.org/) no servidor web, se você ainda não o fez. - ⚠️ Definir a raiz do documento do servidor web para a subpasta `public/` dentro da pasta `castopod`. 4. Adicionar **tarefas cron** no seu servidor web para vários processos em segundo plano (substitua os caminhos adequadamente): - Para que os recursos sociais funcionem corretamente, esta tarefa é usada para transmitir atividades sociais para seus seguidores no fediverso: ```bash * * * * * /path/to/php /path/to/castopod/public/index.php scheduled-activities ``` - Para que seus episódios sejam transmitidos em hubs abertos após a publicação usando [WebSub](https://en.wikipedia.org/wiki/WebSub): ```bash * * * * * /usr/local/bin/php /castopod/public/index.php scheduled-websub-publish ``` - Para que os clipes de vídeo sejam criados (veja [requisitos de FFmpeg](#ffmpeg-v418-or-higher-for-video-clips)): ```bash * * * * * /path/to/php /path/to/castopod/public/index.php scheduled-video-clips ``` > Essas tarefas são executadas **a cada minuto**. Você pode definir a > freqüência dependendo de suas necessidades: a cada 5, 10 minutos ou mais. ### (recomendado) Assistente de Instalação 1. Execute o script de instalação do Castopod acessando a página do assistente de instalação (`https://your_domain_name.com/cp-install`) no seu navegador favorito. 2. Siga as instruções na sua tela. 3. Comece o podcast! ::: Nota de Informação O script de instalação grava um arquivo `.env` na raiz do pacote. If you cannot go through the install wizard, you can create and edit the `.env` file manually based on the `.env.example` file. ::: ### 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" ``` #### Configurar opções de e-mail | Nome da variável | Tipo | Padrão | | ---------------- | -------------------- | ------------ | | **`fromEmail`** | string | `indefinido` | | **`fromName`** | string | `"Castopod"` | | **`SMTPHost`** | string | `undefined` | | **`SMTPUser`** | string | `undefined` | | **`SMTPPass`** | string | `undefined` | | **`SMTPPort`** | number | `25` | | **`SMTPCrypto`** | [`"tls"` or `"ssl"`] | `"tls"` | ### S3 By default, files are stored in the `public/media` folder using the filesystem. If you prefer storing your media files on an S3 compatible storage, you may specify it in your `.env`: ```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` | ## Pacotes comunitários 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.
Instalar Castopod com YunoHost Github Repo