> ## 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 Instalação Self-Hosted

> Guia completo para instalar e configurar uma instância pronta para produção do AirysChat na sua própria infraestrutura.

Bem-vindo ao guia de instalação self-hosted do AirysChat. Esta documentação abrangente o ajudará a implantar, configurar e manter sua própria instância do AirysChat com controle total sobre seus dados e infraestrutura.

## Por que fazer o Self-Host do AirysChat?

Hospedar o AirysChat você mesmo oferece controle completo sobre sua plataforma de suporte ao cliente:

* **Privacidade de Dados**: Mantenha todos os dados do cliente em seus próprios servidores
* **Personalização**: Modifique a plataforma para atender às suas necessidades específicas
* **Controle de Custos**: Sem preços por agente - escale o quanto precisar
* **Conformidade**: Atenda a requisitos regulatórios específicos
* **Integração**: Integração profunda com sua infraestrutura existente

## Opções de Implantação

O AirysChat suporta vários métodos de implantação para atender a diferentes necessidades de infraestrutura:

### 🐧 Implantação em Linux VM

Implante diretamente em máquinas virtuais Ubuntu/Linux com nosso script de instalação automatizado.

* **Melhor para**: Ambientes de servidor tradicionais
* **Complexidade**: Baixa a Média
* **Manutenção**: Atualizações manuais necessárias

### 🐳 Implantação com Docker

Use contêineres Docker para implantações consistentes e portáteis.

* **Melhor para**: Ambientes conteinerizados
* **Complexidade**: Média
* **Manutenção**: Atualizações fáceis com pull de contêineres

### ☸️ Implantação com Kubernetes

Implante em clusters Kubernetes para operações em escala corporativa.

* **Melhor para**: Implantações de grande escala e alta disponibilidade
* **Complexidade**: Alta
* **Manutenção**: Automatizada com CI/CD adequado

### ☁️ Implantações em Provedores de Nuvem

Implantações com um clique nas principais plataformas de nuvem:

* **AWS**: Opções EC2, ECS e Marketplace
* **Azure**: Container Instances e implantações de VM
* **DigitalOcean**: Droplets e App Platform
* **Google Cloud**: Compute Engine e Cloud Run
* **Heroku**: Implantação simples com um clique

## Requisitos do Sistema

### Requisitos Mínimos

* **CPU**: 2 núcleos
* **RAM**: 4GB
* **Armazenamento**: 20GB SSD
* **SO**: Ubuntu 20.04+ ou distribuição Linux compatível

### Recomendado para Produção

* **CPU**: 4+ núcleos
* **RAM**: 8GB+
* **Armazenamento**: 50GB+ SSD
* **Banco de Dados**: PostgreSQL 12+
* **Cache**: Redis 6+
* **Proxy Reverso**: Nginx ou similar

## O que Você Precisará

Antes de iniciar sua instalação do AirysChat, certifique-se de ter:

### Requisitos Técnicos

* [ ] Servidor ou instância na nuvem que atenda aos requisitos mínimos
* [ ] Nome de domínio (recomendado para produção)
* [ ] Certificado SSL (Let's Encrypt recomendado)
* [ ] Servidor SMTP para notificações por e-mail

### Requisitos de Acesso

* [ ] Acesso SSH ao seu servidor
* [ ] Privilégios de root ou sudo
* [ ] Acesso à configuração do firewall

### Opcional, mas Recomendado

* [ ] Armazenamento de objetos (AWS S3, Google Cloud Storage, etc.)
* [ ] CDN para ativos estáticos
* [ ] Ferramentas de monitoramento (APM, logs)
* [ ] Solução de backup

## Considerações de Segurança

Ao hospedar o AirysChat você mesmo, considere estes aspectos de segurança:

* **Atualizações Regulares**: Mantenha o AirysChat e os pacotes do sistema atualizados
* **Configuração de Firewall**: Exponha apenas as portas necessárias
* **SSL/TLS**: Sempre use HTTPS em produção
* **Segurança do Banco de Dados**: Proteja o PostgreSQL com senhas fortes
* **Criptografia de Backup**: Criptografe dados sensíveis de backup
* **Controle de Acesso**: Implemente controles de acesso de usuário adequados

## Começando

Pronto para implantar o AirysChat? Escolha seu método de implantação preferido:

<CardGroup cols={2}>
  <Card title="Início Rápido com Docker" icon="docker" href="/self-hosted/deployment/docker">
    Comece a usar rapidamente com contêineres Docker
  </Card>

  <Card title="Instalação em Linux VM" icon="server" href="/self-hosted/deployment/linux-vm">
    Implantação de servidor tradicional com nosso script automatizado
  </Card>

  <Card title="Implantação em Kubernetes" icon="dharmachakra" href="/self-hosted/deployment/helm-chart">
    Implantação em escala corporativa no Kubernetes
  </Card>

  <Card title="Provedores de Nuvem" icon="cloud" href="/self-hosted/deployment/aws">
    Implantações com um clique nas principais plataformas de nuvem
  </Card>
</CardGroup>

## Comunidade e Suporte

* **Documentação**: Guias abrangentes e referências de API
* **GitHub**: [Código fonte e rastreamento de issues](https://github.com/airyschat/airyschat)
* **Discord**: [Chat e suporte da comunidade](https://discord.gg/cJXdrwS)
* **Fórum**: [Discussões da comunidade e Q\&A](https://github.com/airyschat/airyschat/discussions)
