castopod/docs/src/pt-BR/getting-started/install.md

6.9 KiB

title sidebarDepth
Instalação 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:

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

Banco de dados compatível com MySQL

Recomendamos usar o MariaDB.

::: 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 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.

(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

  1. Obter um servidor web com os requisitos instalados

  2. 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).

  3. Ativar HTTPS em seu domínio com um certificado SSL.

  4. Baixar e descompactar o último Pacote Castopod 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.
  5. 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:
       * * * * * /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:
       * * * * * /usr/local/bin/php /castopod/public/index.php scheduled-websub-publish
    
       * * * * * /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.

:::

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 é 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 com o Docker

Se você deseja usar o Docker para instalar o Castopod, é possível graças a Romain de Laage!

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.

:::