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

123 lines
5.1 KiB
Markdown
Raw Normal View History

2022-04-14 15:11:07 +02:00
---
title: Instalação
2022-04-14 15:11:07 +02:00
sidebarDepth: 3
---
# Como instalar o Castopod
2022-04-14 15:11:07 +02:00
O Castopod foi projetado para ser fácil de instalar. Se você estiver usando um
hospedagem dedicada ou compartilhada, você pode instalá-lo na maioria dos
servidores web compatíveis com PHP-MySQL.
2022-04-14 15:11:07 +02:00
::: tip Nota
2022-08-22 17:56:51 +02:00
Publicamos imagens oficiais do Docker para o Castopod!
2022-07-04 15:27:21 +02:00
Se você preferir usar o Docker, você pode pular esta parte e ir diretamente para a [documentação Docker](./docker.md) para o Castopod.
2022-07-04 15:27:21 +02:00
:::
## Pré-requisitos
2022-04-14 15:11:07 +02:00
- PHP v8.1
- MySQL versão 5.7 ou superior ou MariaDB versão 10.2 ou superior
- Suporte HTTPS
- Um [ntp-synced clock](https://wiki.debian.org/NTP) para validar as solicitações de federação
2022-04-14 15:11:07 +02:00
### PHP v8.1
2022-04-14 15:11:07 +02:00
A versão 8.1 do PHP é necessária, com as seguintes extensões instaladas:
2022-04-14 15:11:07 +02:00
- [intl](https://www.php.net/manual/fr/intl.requirements.php)
- [libcurl](https://www.php.net/manual/fr/curl.requirements.php)
- [mbstring](https://www.php.net/manual/fr/mbstring.installation.php)
- [gd](https://www.php.net/manual/en/image.installation.php) com bibliotecas **JPEG**, **PNG** e **WEBP**.
- [exif](https://www.php.net/manual/fr/exif.installation.php)
2022-04-14 15:11:07 +02:00
Além disso, verifique se as seguintes extensões estão habilitadas no seu PHP:
2022-04-14 15:11:07 +02:00
- json (habilitado por padrão - não desabilite)
- xml (habilitado por padrão - não desabilite)
- [mysqlnd](https://www.php.net/manual/fr/mysqlnd.install.php)
2022-04-14 15:11:07 +02:00
### Banco de dados compatível com o MySQL
2022-04-14 15:11:07 +02:00
> Recomendamos o uso do [MariaDB](https://mariadb.org).
2022-04-14 15:11:07 +02:00
::: warning Atenção
2022-04-14 15:11:07 +02:00
O Castopod só funciona com bancos de dados do MySQL versão 5.7 ou superior. As versões 5.6 (que tiveram suporte encerrado em 5 de fevereiro de 2021) ou anteriores do MySQL não funcionarão.
2022-04-14 15:11:07 +02:00
:::
Você precisará do nome do host do servidor, nome do banco de dados, nome de usuário e senha para concluir o processo de instalação. Se você não tiver essas informações, entre em contato com seu administrador.
2022-04-14 15:11:07 +02:00
### (Opcional) FFmpeg v4.1.8 ou superior para clipes de vídeo
2022-04-14 15:11:07 +02:00
O [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 estar instaladas:
2022-04-14 15:11:07 +02:00
- biblioteca **FreeType 2** para [gd](https://www.php.net/manual/en/image.installation.php).
2022-04-14 15:11:07 +02:00
### (Opcional) Outras recomendações
2022-04-14 15:11:07 +02:00
- Redis para melhor desempenho em cache.
- CDN para cache de arquivos estáticos e melhor desempenho.
- Gateway de e-mail para senhas perdidas.
2022-04-14 15:11:07 +02:00
## Instruções de instalação
2022-04-14 15:11:07 +02:00
### Pré-requisitos
2022-04-14 15:11:07 +02:00
0. Obtenha um servidor web com [os pré-requisitos](#pré-requisitos) instalados.
1. Crie um banco de dados MySQL para o Castopod com um usuário com as permissões necessárias (para mais informações, consulte [Banco de dados compatível com o MySQL](#banco-de-dados-compatível-com-o-mysql)).
2. Ative o HTTPS em seu domínio com um _certificado SSL_.
3. Baixe e descompacte o pacote mais recente do [Castopod](https://castopod.org/) no servidor web, se ainda não o tiver feito.
- ⚠️ Certifique-se de apontar a raiz do documento do servidor da web para a subpasta `public/` da pasta `castopod`.
4. Adicione **tarefas cron** no seu servidor web para vários processos em segundo plano (substitua os caminhos conforme necessário):
2022-04-14 15:11:07 +02:00
```bash
* * * * * /caminho/para/php /caminho/para/castopod/spark tasks:run >> /dev/null 2>&1
2022-04-14 15:11:07 +02:00
```
**Observação** - Se você não adicionar essa tarefa cron, os seguintes recursos do Castopod não funcionarão:
2022-04-14 15:11:07 +02:00
- Importar um podcast de um feed RSS existente
- Transmitir atividades sociais para seus seguidores no Fediverso
- Transmitir episódios para hubs abertos usando o [WebSub](https://en.wikipedia.org/wiki/WebSub)
- Gerar clipes de vídeo - [requer FFmpeg](#opcional-ffmpeg-v418-ou-superior-para-clipes-de-vídeo)
2022-04-14 15:11:07 +02:00
### (Método recomendado) Assistente de instalação
2022-04-14 15:11:07 +02:00
1. Execute o script de instalação do Castopod acessando a página do assistente de instalação (`https://seu_nome_de_domínio.com/cp-install`) em seu navegador da web favorito.
2. Siga as instruções exibidas.
3. Comece a podcastar!
2022-04-14 15:11:07 +02:00
:::info Nota
2022-04-14 15:11:07 +02:00
O script de instalação criará um arquivo `.env` na raiz do pacote. Se você não conseguir usar o assistente de instalação, poderá criar e editar o arquivo `.env` manualmente, com base no arquivo `.env.example`.
2022-04-14 15:11:07 +02:00
:::
### Configuração de e-mail/SMTP
2023-04-01 14:38:40 +02:00
A configuração de e-mail é necessária para que alguns recursos funcionem corretamente (por exemplo, recuperar sua senha esquecida, enviar instruções para assinantes premium, ...)
2023-04-01 14:38:40 +02:00
Você pode adicionar a configuração de e-mail no arquivo `.env` de sua instância da seguinte maneira:
2023-03-16 17:45:41 +01:00
```ini
# [...]
2023-03-16 17:45:41 +01:00
email.fromEmail="seu_endereço_de_email"
email.SMTPHost="seu_host_smtp"
email.SMTPUser="seu_usuario_smtp"
email.SMTPPass="sua_senha_smtp"
2023-03-16 17:45:41 +01:00
```
#### Opções de configuração de e-mail
2022-04-14 15:11:07 +02:00
| Nome da variável | Tipo | Valor padrão |
| ---------------- | -------------------- | -------------- |
| **`fromEmail`** | string | `undefined` |
| **`fromName`** | string | `"Castopod"` |
| **`SMTPHost`** | string | `undefined` |
| **`SMTPUser`** | string | `undefined`