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

# Implantação da AMI do AWS Marketplace

> Implante o AirysChat na AWS usando a listagem de AMI do marketplace

# Guia de Implantação do AirysChat na AWS

A seguir está o guia para implantar o AirysChat na AWS usando a listagem do marketplace. Use nossos helm charts com o AWS Elastic Kubernetes Service(EKS) para uma implantação nativa em nuvem.

## Pré-requisitos

* Conta na AWS

## Instalar AirysChat via AWS Marketplace AMI

### Passo 1: Assinar o AirysChat

1. Acesse a [listagem do AirysChat no AWS marketplace](https://aws.amazon.com/marketplace/pp/prodview-tolblk4kmdqd4) e clique em **Subscribe**.

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/aws-ami/awsmp-01-subscribe.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=84b6d064f58194586614168fb10da707" alt="Assinar o AirysChat" width="2784" height="952" data-path="self-hosted/images/aws-ami/awsmp-01-subscribe.png" />

### Passo 2: Fazer Login

2. Faça login com sua conta da AWS.

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/aws-ami/awsmp-02-signin.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=2588dbd3fc31bd907543dbfbfecbf67d" alt="Login na AWS" width="442" height="571" data-path="self-hosted/images/aws-ami/awsmp-02-signin.png" />

### Passo 3: Continuar para Configuração

3. Clique em **Continue to Configuration**.

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/aws-ami/awsmp-03-continue.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=9f72f35d69d04dd1a23afc4c2a91416b" alt="Continuar para Configuração" width="1250" height="358" data-path="self-hosted/images/aws-ami/awsmp-03-continue.png" />

### Passo 4: Configurar Software

4. Selecione a versão mais recente em **Software Version** e escolha sua **region** da AWS. Clique em **Continue to Launch**.

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/aws-ami/awsmp-04-configure.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=0e4514c146ebcc1e60dda19d45722af7" alt="Configurar Software" width="889" height="830" data-path="self-hosted/images/aws-ami/awsmp-04-configure.png" />

### Passo 5: Configuração de Lançamento

5. Revise a configuração de lançamento. Deixe o campo **Choose Action** com o valor padrão **Launch from Website**. Escolha uma VPC e uma sub-rede de acordo com sua preferência de região da AWS.

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/aws-ami/awsmp-05-launch.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=1c7ec847d15f3ac227860ba0666010c9" alt="Configuração de Lançamento" width="912" height="876" data-path="self-hosted/images/aws-ami/awsmp-05-launch.png" />

### Passo 6: Criar Grupo de Segurança

6. Role para baixo até a seção **Security Group** e clique em **Create New Based On Seller Settings**.

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/aws-ami/awsmp-06-sg.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=8f6ac0b071b753ec2b2be6353c92502a" alt="Criar Grupo de Segurança" width="796" height="266" data-path="self-hosted/images/aws-ami/awsmp-06-sg.png" />

### Passo 7: Salvar Grupo de Segurança

7. Salve o novo grupo de segurança e escolha-o após a criação.

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/aws-ami/awsmp-07-sg.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=54985f29fc527b53abb682918bab16c3" alt="Salvar Grupo de Segurança" width="924" height="646" data-path="self-hosted/images/aws-ami/awsmp-07-sg.png" />

### Passo 8: Configurar Par de Chaves

8. Escolha um par de chaves que você já possui ou crie um novo na região em que está implantando. Clique em **Launch**.

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/aws-ami/awsmp-08-keypair.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=043b6b621ea05f45f2fbe1e74acc3f6f" alt="Configurar Par de Chaves" width="931" height="538" data-path="self-hosted/images/aws-ami/awsmp-08-keypair.png" />

### Passo 9: Confirmação de Lançamento

9. A AWS agora deve exibir uma tela de parabéns confirmando que a instância do AirysChat foi iniciada com sucesso. Clique no link **EC2 Console**.

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/aws-ami/awsmp-09-launch.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=2229e99f65ca16787316bc4449756dea" alt="Confirmação de Lançamento" width="924" height="306" data-path="self-hosted/images/aws-ami/awsmp-09-launch.png" />

### Passo 10: Aguardar a Instância

10. Aguarde alguns minutos para deixar a instância iniciar.

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/aws-ami/awsmp-10-ec2.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=859f8e80fc10cdae0b6f1b90b07a8c3e" alt="Aguardar a Instância" width="1886" height="249" data-path="self-hosted/images/aws-ami/awsmp-10-ec2.png" />

### Passo 11: Obter IP Público

11. Selecione a instância e copie o IP público.

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/aws-ami/awsmp-11-public-ip.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=0965688da1749cb238ccf6c6c3587f41" alt="Obter IP Público" width="1112" height="253" data-path="self-hosted/images/aws-ami/awsmp-11-public-ip.png" />

### Passo 12: Acessar o AirysChat

12. Visite `http://<your-public-ip>:3000`. Isso deve abrir a interface do AirysChat. Parabéns. Uhuuu!

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/aws-ami/awsmp-12-airyschat.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=4f8af389fec8573f883ce549d24539e8" alt="Acessar o AirysChat" width="1327" height="1017" data-path="self-hosted/images/aws-ami/awsmp-12-airyschat.png" />

## Configurando o AirysChat

Para configurar o AirysChat, precisamos acessar a instância via SSH. Usaremos o **AWS Console Connect** para isso.

### Passo 1: Conectar à Instância

1. Selecione a instância e clique em **Connect**.

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/aws-ami/awsmp-13-connect.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=617fae310700058cdc7238dac33a4e24" alt="Conectar à Instância" width="1272" height="412" data-path="self-hosted/images/aws-ami/awsmp-13-connect.png" />

### Passo 2: Usar Usuário Ubuntu

2. Altere o nome de usuário de `root` para `ubuntu` e clique em **Connect**.

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/aws-ami/awsmp-14-connect.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=8621ea36d9b5b7d78155fbbad019d52a" alt="Usar Usuário Ubuntu" width="1182" height="783" data-path="self-hosted/images/aws-ami/awsmp-14-connect.png" />

### Passo 3: Configurar Variáveis de Ambiente

3. Mude para o usuário `airyschat` e configure as variáveis de ambiente necessárias. Consulte o documento [Variáveis de ambiente](/self-hosted/configuration/environment-variables) para a lista completa.

```bash theme={null}
sudo -i -u airyschat
cd airyschat
vi .env
```

<Note>
  É recomendado configurar um servidor proxy como Nginx e configurar SSL. Certifique-se de modificar o grupo de segurança criado no passo 6 de acordo.
</Note>

## Atualizando a Instância

Por favor, siga o processo de atualização do AirysChat na configuração padrão de [VM Linux](/self-hosted/deployment/linux-vm).

## Recomendações de Segurança

### Configuração SSL

* Configure certificados SSL usando Let's Encrypt ou AWS Certificate Manager
* Configure Nginx como um proxy reverso
* Atualize as regras do grupo de segurança para permitir o tráfego HTTPS (porta 443)

### Controle de Acesso

* Restrinja o acesso SSH a endereços IP específicos
* Use funções IAM para instâncias EC2 sempre que possível
* Habilite o AWS CloudTrail para logs de auditoria

### Estratégia de Backup

* Configure snapshots automatizados do EBS
* Configure backups de banco de dados
* Armazene backups no S3 com políticas de ciclo de vida apropriadas

## Solução de Problemas

### Problemas Comuns

<Accordion title="Instância não acessível">
  **Problema**: Não é possível acessar o AirysChat na porta 3000

  **Soluções**:

  * Verifique se o grupo de segurança permite o tráfego de entrada na porta 3000
  * Verifique se a instância está em execução e saudável
  * Verifique se o serviço do AirysChat está em execução: `sudo systemctl status airyschat`
</Accordion>

<Accordion title="O aplicativo não está iniciando">
  **Problema**: O serviço do AirysChat falha ao iniciar

  **Soluções**:

  * Verifique os logs: `sudo journalctl -u airyschat -f`
  * Verifique se as variáveis de ambiente estão configuradas corretamente
  * Garanta que a conexão com o banco de dados está funcionando
  * Verifique o espaço em disco e o uso de memória
</Accordion>

### Recursos de Suporte

* [Suporte AWS](https://aws.amazon.com/support/)
* [Discord da Comunidade AirysChat](https://discord.com/invite/cJXdrwS)
* [Problemas no GitHub](https://github.com/airyschat/airyschat/issues)

***

A AMI do AWS Marketplace fornece uma maneira rápida de implantar o AirysChat com configurações pré-definidas. Para uso em produção, certifique-se de implementar medidas de segurança e estratégias de backup adequadas.
