> ## Documentation Index
> Fetch the complete documentation index at: https://docs.airys.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Guia de implantação em Produção do AirysChat no Caprover

> Implante o AirysChat usando o gerenciamento de aplicativos de um clique do Caprover

## Visão Geral do Caprover

Caprover é uma ferramenta de gerenciamento de servidores de aplicativos extremamente fácil de usar. É muito rápida e usa Docker nos bastidores. O AirysChat foi disponibilizado como um aplicativo de um clique no Caprover, e o processo de implantação é simples.

<Note>
  Esta é uma configuração de instalação contribuída pela comunidade. Terá apenas suporte da comunidade para quaisquer problemas no futuro.
</Note>

## Configurar AirysChat Usando o Caprover

### 1. Instale o Caprover na sua VM

Termine sua instalação do Caprover consultando o [Guia de introdução](https://caprover.com/docs/get-started.html).

### 2. Instale o AirysChat

O AirysChat está disponível na opção de aplicativos de um clique no Caprover. Busque por AirysChat na lista de aplicativos de um clique. Substitua a `version` padrão pela última `version` do airyschat. Use valores apropriados para as senhas do Postgres e do Redis e clique em install. Deve demorar apenas alguns minutos.

### 3. Conclua a configuração

Vá até o serviço `web` nas aplicações do Caprover e habilite o `Websocket Support` nas configurações HTTP para true. Você também pode habilitar `https` para a aplicação.

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/caprover-websocket.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=30c1ad7cb36df93eea841516ac33a870" alt="caprover-enable-websocket" width="3584" height="2274" data-path="self-hosted/images/caprover-websocket.png" />

### 4. Configurar variáveis de ambiente

O Caprover cuidará da instalação do Postgres e do Redis, juntamente com o aplicativo e os servidores de trabalho. Recomendamos que você substitua os serviços do Database/Redis por servidores gerenciados/autônomos quando começar a escalar.

Além disso, certifique-se de configurar as variáveis de ambiente apropriadas para e-mail, serviço de Object Store etc. usando nosso [Guia de Variáveis de Ambiente](/self-hosted/configuration/environment-variables)

<Note>
  O AirysChat requer suporte a websocket. Habilite-o na página de configurações do `airyschat-web` no Caprover.
</Note>

## Atualizando a instalação do AirysChat

Para atualizar sua instalação do airyschat para a versão mais recente no Caprover, execute o seguinte comando na aba de deployment para web e worker em `method 5: deploy captain-definition`. Certifique-se de substituir `[DESIRED VERSION HERE]` com a versão estável atual mais recente. Verifique [aqui](https://www.airyschat.com/changelog/) e [aqui](https://hub.docker.com/r/airyschat/airyschat/tags) para possíveis números de versão primeiro.

### web

```json theme={null}
{
  "schemaVersion": 2,
  "dockerfileLines": [
    "FROM airyschat/airyschat:[DESIRED VERSION HERE]",
    "RUN chmod +x docker/entrypoints/rails.sh",
    "ENTRYPOINT [\"docker/entrypoints/rails.sh\"]",
    "CMD bundle exec rake db:airyschat_prepare; bundle exec rails s -b 0.0.0.0 -p 3000"
  ]
}
```

### worker

```json theme={null}
{
  "schemaVersion": 2,
  "dockerfileLines": [
    "FROM airyschat/airyschat:[DESIRED VERSION HERE]",
    "RUN chmod +x docker/entrypoints/rails.sh",
    "ENTRYPOINT [\"docker/entrypoints/rails.sh\"]",
    "CMD bundle exec sidekiq -C config/sidekiq.yml"
  ]
}
```

## Acessando o Console do Rails

Faça login no servidor onde você tem o caprover instalado e execute os seguintes comandos.

```bash theme={null}
# access the shell inside the container
docker exec -it $(docker ps --filter name=srv-captain--airyschat-web -q) /bin/sh
# start rails console
RAILS_ENV=production bundle exec rails c
```

## Erros Comuns

### Falha nas requisições da API com "You need to sign in or sign up before continuing."

O Nginx, por padrão, remove os cabeçalhos com `_`. Vá para a opção de configuração do Nginx no caprover em AirysChat web e adicione a seguinte diretiva.

Acesse o `web dashboard` do Caprover > `Apps` > `Apps Edit` > `Edit Default Nginx Configurations`. Consulte [https://caprover.com/docs/nginx-customization.html](https://caprover.com/docs/nginx-customization.html) para mais detalhes.

```nginx theme={null}
# Nginx strips out underscore in headers by default
# AirysChat relies on underscore in headers for API
# Make sure that the config is set to on.
underscores_in_headers on;
```

### Problemas relacionados à persistência de armazenamento

Por favor, configure um armazenamento na nuvem como s3 ou bucket gcs ou qualquer serviço compatível com a API s3 como o serviço de armazenamento ativo.
A instalação do Caprover necessita disso para persistência de armazenamento. Consulte o [guia de armazenamento](/self-hosted/deployment/storage/supported-providers).

## Outras referências

* [https://isotropic.co/how-to-install-airyschat-to-a-digitalocean-droplet/](https://isotropic.co/how-to-install-airyschat-to-a-digitalocean-droplet/)