--- 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. ## Requisitos - PHP v8.0 ou superior - MySQL versão 5.7 ou superior ou MariaDB versão 10.2 ou superior - Suporte a HTTPS ### PHP v8.0 ou superior É necessário PHP versão 8.0 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 compatíveis com MySQL 5.7 ou superior. Vai quebrar com a versão anteiror do MySQL, v5.6, por exemplo, pois teve seu ciclo encerrado em 5 de fevereiro de 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 O usuário deve ter pelo menos estes privilégios no banco de dados para que o Castopod funcione: `CREATE`, `ALTER`, `DELETE`, `EXECUTE`, `INDEX`, `INSERT`, `SELECT`, `UPDATE`. ### (Opcional) FFmpeg v4.1.8 ou superior para Clipes de Vídeo [FFmpeg](https://www.ffmpeg.org/) versão 4.1.8 ou superior é necessário se você deseja gerar Clipes de Vídeo. 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! ::: info Nota O script de instalação grava um arquivo `.env` na raiz do pacote. Se você não puder passar pelo assistente de instalação, você pode [criar e atualizar o arquivo `.env` manualmente](#alternative-manual-configuration). ::: ## Pacotes comunitários Se você não quiser se preocupar em instalar o Castopod manualmente, você pode usar um dos pacotes criados e mantidos pela comunidade de código aberto. ### Instalar com YunoHost [YunoHost](https://yunohost.org/) é uma distribuição baseada no Debian GNU/Linux composta por pacotes de software livre e de código aberto. Ele gerencia as dificuldades de auto-hospedagem para você.
Instalar Castopod com YunoHost Github Repo
### Instalar com o Docker Se você deseja usar o Docker para instalar o Castopod, é possível graças a [Romain de Laage](https://mamot.fr/@rdelaage)! Instalar com o Docker ::: info Nota Dado o alto nível de demanda por docker, planejamos manter uma imagem oficial do Castopod Docker diretamente no repositório do Castopod. :::