Infraestrutura
Appwrite self-hosted: quanto de VPS você precisa?
Aprenda a instalar e dimensionar Appwrite self-hosted em VPS, com CPU, RAM, Docker, backups, segurança, monitoramento e operação estável em produção real.
Resposta direta
Para executar Appwrite self-hosted em uma VPS de produção, comece com 4 vCPUs, 8 GB de RAM, 100 a 120 GB de SSD ou NVMe e uma distribuição Linux com suporte ativo. Uma instalação de testes pode funcionar com 2 vCPUs e 4 GB, mas a margem fica curta quando banco de dados, Redis, workers, Realtime, armazenamento e Functions trabalham ao mesmo tempo. O Appwrite é distribuído como uma composição de contêineres Docker, portanto o dimensionamento precisa considerar a plataforma inteira, não apenas a API. Em produção, use domínio próprio, HTTPS, firewall, monitoramento, backup externo e teste periódico de restauração. Projetos com muitas funções, arquivos grandes ou conexões em tempo real podem exigir 8 vCPUs, 16 GB de RAM e armazenamento separado antes de atingirem um volume elevado de usuários.
Resumo rápido
- Use 2 vCPUs e 4 GB de RAM apenas para desenvolvimento, homologação ou tráfego pequeno e previsível.
- Adote 4 vCPUs e 8 GB de RAM como ponto de partida mais seguro para uma aplicação comercial em produção.
- Reserve pelo menos 100 GB de SSD ou NVMe quando houver banco, uploads, imagens e builds de Functions no mesmo host.
- Instale o Appwrite pelo procedimento oficial, mantenha Docker e Compose atualizados e fixe uma versão antes de cada atualização.
- Publique somente as portas 80 e 443, além da porta SSH restrita ao endereço administrativo sempre que possível.
- Copie banco de dados, uploads, configurações, certificados e artefatos persistentes para um destino externo à VPS.
- Monitore memória, swap, latência de disco, espaço livre, reinícios de contêineres e tempo de resposta da API.
Como o Appwrite self-hosted usa a infraestrutura
Appwrite self-hosted oferece autenticação, bancos de dados, armazenamento de arquivos, Functions, mensageria interna, Realtime e uma interface administrativa. Essa praticidade tem um custo operacional: a instalação executa diversos contêineres com perfis de consumo diferentes. A API recebe requisições, workers processam tarefas assíncronas, o banco mantém dados persistentes, o Redis auxilia filas e estados temporários, enquanto componentes de telemetria e execução também consomem recursos. A composição exata pode mudar entre versões, por isso o arquivo oficial da versão instalada deve ser a referência.
Serviços que disputam CPU, memória e disco
Uma API com 30 requisições por segundo pode usar pouca CPU se fizer consultas simples. O cenário muda quando as mesmas requisições incluem upload de imagens, criação de miniaturas e disparo de Functions. Dois uploads simultâneos de 100 MB geram tráfego, escrita em disco e processamento adicional. Uma Function Node.js limitada a 512 MB, executada oito vezes em paralelo, também pode pressionar uma VPS de 4 GB mesmo que cada execução não use toda a cota.
O banco de dados prefere memória disponível para cache. Já builds de Functions criam picos de CPU, disco e rede ao baixar dependências. Realtime mantém conexões abertas, o que aumenta a importância de limites de arquivos, sockets e estabilidade da rede. Esse comportamento composto explica por que uma máquina aparentemente ociosa pode sofrer durante uma implantação ou rotina de importação.
Quem ainda está avaliando plataformas pode comparar essa arquitetura com o processo descrito em Supabase self-hosted em VPS. As duas soluções reúnem vários serviços, mas possuem componentes, rotinas de atualização e modelos de execução diferentes.
VPS tradicional ou Cloud Server
Uma VPS tradicional pode atender bem cargas previsíveis, desde que CPU, memória e disco tenham desempenho consistente. Um Cloud Server costuma facilitar aumento de recursos, snapshots e automação, mas esses recursos dependem do provedor e do plano. O nome comercial não garante alta disponibilidade. Se todos os contêineres e volumes continuam em uma única instância, uma falha dessa instância ainda interrompe o ambiente. Para reduzir esse risco, são necessários backups externos, restauração documentada e, em projetos críticos, separação planejada de componentes persistentes.
CPU, RAM, disco e rede para cada carga
Não existe uma configuração universal para Appwrite self-hosted. O consumo depende do número de projetos, conexões Realtime, tamanho dos arquivos, frequência das consultas e concorrência de Functions. Ainda assim, é possível escolher um ponto inicial coerente e revisar o plano com métricas reais após uma ou duas semanas de uso.
Configurações iniciais por perfil
| Perfil | CPU e memória | Armazenamento inicial | Rede mensal sugerida | Cenário típico |
|---|---|---|---|---|
| Desenvolvimento e homologação | 2 vCPUs, 4 GB de RAM | 60 GB SSD | 1 TB ou medição equivalente | Um desenvolvedor, poucos projetos, Functions ocasionais e sem SLA |
| Produto pequeno em produção | 4 vCPUs, 8 GB de RAM | 120 GB SSD ou NVMe | 2 TB ou mais | Até dezenas de requisições por segundo, uploads moderados e equipe pequena |
| Produção com carga variável | 8 vCPUs, 16 GB de RAM | 250 GB NVMe | 4 TB ou mais | Realtime, Functions concorrentes, arquivos e rotinas assíncronas frequentes |
| Ambiente crítico | 8 ou mais vCPUs, 16 a 32 GB de RAM | 500 GB ou storage externo | Dimensionada por telemetria | Aplicação comercial com recuperação testada e componentes separados |
Esses números são referências de planejamento, não benchmarks. Uma aplicação de chat com 2 mil conexões persistentes se comporta de forma diferente de um painel administrativo com 20 usuários. Da mesma forma, 100 mil registros pequenos podem ser mais simples de operar do que 5 mil imagens originais com vários gigabytes.
Para o disco, mantenha ao menos 25% de espaço livre. Em uma unidade de 120 GB, planeje alertas em 75% e ação imediata em 85%. Builds, logs e imagens Docker antigas podem ocupar dezenas de gigabytes sem aparecer no painel do Appwrite. O comando docker system df ajuda a localizar esse crescimento, mas a remoção deve ser feita com cuidado para não apagar imagens ou volumes necessários.
Como medir antes de aumentar o plano
Faça um teste que reproduza a aplicação real. Um exemplo útil combina 20 usuários autenticando, 10 uploads de 20 MB e cinco Functions simultâneas por 15 minutos. Registre CPU, memória, I/O wait e latência p95 da API. Se a memória permanecer acima de 85%, houver uso frequente de swap ou o I/O wait superar 10% durante vários minutos, aumentar RAM ou melhorar o armazenamento pode ser mais eficaz que adicionar apenas CPU.
Para entender limites e práticas do runtime, consulte também o conteúdo sobre Docker em VPS. Ele ajuda a separar consumo do host, limites dos contêineres e problemas causados por imagens acumuladas.
Preparação da VPS e instalação com Docker
Escolha uma distribuição com suporte ativo, como uma versão LTS do Ubuntu Server, e faça a instalação em uma VPS limpa. Misturar Appwrite, servidor de e-mail, painel de hospedagem e outros bancos no mesmo host aumenta a superfície de ataque e torna os picos de consumo difíceis de diagnosticar. Antes de instalar, confirme arquitetura compatível, espaço livre, resolução DNS e acesso administrativo por SSH.
Sistema operacional e pré-requisitos
Atualize os pacotes e instale Docker Engine e o plugin Docker Compose usando o repositório oficial do Docker. Evite scripts copiados de fóruns, pois eles podem instalar versões antigas ou alterar regras de rede sem explicar o impacto. Uma checagem inicial pode usar:
sudo apt update
sudo apt upgrade -y
docker version
docker compose version
free -h
df -h
Configure o fuso horário do sistema, sincronização NTP e um hostname identificável. Se a VPS tiver 8 GB de RAM, uma swap de 2 a 4 GB pode impedir encerramentos abruptos durante um pico curto. Ela não substitui RAM. Uso contínuo de swap sinaliza que a carga precisa ser reduzida ou que o plano deve crescer.
Também é sensato configurar rotação dos logs do Docker. Sem limite, um contêiner emitindo erros repetidos pode preencher o disco em poucas horas. Um exemplo de /etc/docker/daemon.json limita cada arquivo a 20 MB e mantém cinco arquivos:
{
"log-driver": "json-file",
"log-opts": {
"max-size": "20m",
"max-file": "5"
}
}
Reinicie o Docker em uma janela controlada, pois esse procedimento pode afetar contêineres em execução.
Instalação e validação inicial
Use o comando de instalação publicado na documentação oficial do Appwrite para a versão escolhida. Não use a tag latest em produção. Fixar a versão torna atualizações e reversões mais previsíveis. Guarde o arquivo Compose, o arquivo de ambiente e uma cópia da versão anterior em um repositório privado ou cofre de configuração, sem publicar segredos.
Depois da instalação, verifique o estado com docker compose ps e acompanhe a inicialização usando docker compose logs --tail=200. Acesse o Console pelo domínio configurado, crie uma conta administrativa e teste três operações: cadastro de usuário, gravação de um documento e upload de um arquivo pequeno. Em seguida, reinicie a pilha com docker compose restart e confirme que os dados continuam disponíveis. Esse teste simples detecta volumes ausentes antes que o ambiente receba dados reais.
Domínio, TLS e segurança do ambiente
O Appwrite precisa de um domínio estável para Console, API, callbacks de autenticação, cookies e Functions. Crie registros DNS apontando para o endereço público da VPS e espere a propagação antes de solicitar certificados TLS. Em uma instalação básica, um registro como appwrite.exemplo.com pode atender o endpoint principal, enquanto o domínio de Functions deve seguir a configuração suportada pela versão instalada.
DNS e portas públicas
Deixe acessíveis pela internet somente as portas exigidas. Normalmente são 80 para validação e redirecionamento HTTP, 443 para HTTPS e uma porta SSH protegida. Banco de dados, Redis e endpoints internos não devem ser publicados no endereço público. Um firewall inicial com UFW pode ser configurado assim:
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status verbose
Se a equipe possui IP fixo ou VPN, restrinja o SSH à rede administrativa. Desabilite login direto de root, use chaves SSH com frase secreta e mantenha uma segunda sessão aberta ao alterar a configuração para evitar bloqueio acidental. O painel do provedor continua útil como acesso de emergência, mas não deve substituir uma política de acesso bem definida.
Evite instalar dois proxies reversos disputando as mesmas portas. O Compose oficial pode incluir o componente responsável pelo roteamento e pelos certificados. Colocar Nginx, Caddy ou um balanceador externo na frente é possível, porém exige ajustar cabeçalhos, WebSocket, tamanho máximo de upload e origem do endereço do cliente. Um erro no suporte a upgrade de conexão costuma aparecer como falha intermitente no Realtime.
Docker socket, firewall e acesso administrativo
A execução de Functions pode exigir integração profunda com o Docker. O socket /var/run/docker.sock equivale a um acesso altamente privilegiado ao host. Não o exponha por TCP, não o compartilhe com contêineres arbitrários e limite quem pode editar o Compose. Usuários do grupo docker também devem ser tratados como administradores do servidor.
Crie projetos separados para desenvolvimento e produção, revise plataformas permitidas e restrinja origens web. Tokens, chaves de API e credenciais administrativas devem ficar em um gerenciador de segredos, nunca dentro do aplicativo cliente ou de uma imagem pública. Um teste prático consiste em tentar acessar uma coleção sem autenticação, enviar um arquivo acima do limite e abrir o Console a partir de uma origem não autorizada. Os três resultados precisam corresponder às políticas definidas.
Persistência, backups e recuperação
Snapshot da VPS não é sinônimo de estratégia completa de backup. Ele pode facilitar uma reversão rápida, mas geralmente fica vinculado à mesma conta, região ou plataforma. Além disso, um snapshot capturado enquanto o banco grava dados pode exigir recuperação adicional. O plano deve combinar cópia consistente do banco, preservação dos volumes necessários e armazenamento em um destino externo.
O que precisa ser preservado
Mapeie os volumes definidos no arquivo Compose da versão instalada. Em geral, a recuperação precisa considerar banco de dados, uploads, configurações, certificados, Functions, builds e demais diretórios persistentes declarados pela plataforma. Redis costuma cumprir uma função temporária, mas a decisão de copiá-lo depende da arquitetura e das orientações da versão em uso.
Para o banco, prefira uma exportação lógica consistente ou uma ferramenta suportada pelo mecanismo utilizado. Um fluxo comum executa o dump pelo contêiner do banco, grava o resultado em diretório protegido e depois envia o arquivo criptografado ao storage externo. As credenciais devem vir das variáveis do ambiente, sem aparecer no histórico do shell ou no script versionado.
Uploads grandes podem ser sincronizados de forma incremental. Um projeto que recebe 5 GB por dia precisa de uma política diferente de um sistema com 2 GB estáticos. Considere retenção diária por 7 dias, semanal por 4 semanas e mensal por 3 meses, ajustando o período às obrigações do negócio. A regra 3-2-1 continua prática: três cópias, dois meios ou sistemas distintos e uma cópia fora do ambiente principal.
O artigo sobre VPS com backup automático explica diferenças entre backup gerenciado, snapshot e cópia externa. Mesmo quando o provedor oferece automação, confirme frequência, retenção, granularidade e procedimento de restauração.
Como testar a restauração
Um backup só ganha valor operacional quando a equipe consegue restaurá-lo. A cada trimestre, crie uma VPS temporária, instale a mesma versão do Appwrite e recupere uma cópia recente. Valide login, documentos, permissões, arquivos e uma Function. Registre o tempo desde o início até a aplicação responder, chamado de RTO, e a idade máxima dos dados recuperados, chamada de RPO.
Se o objetivo for RTO de duas horas e o teste levar seis, o problema pode estar no tamanho dos uploads, na velocidade de transferência ou na falta de documentação. Se o RPO for de uma hora, um backup diário não atende. Essa medição transforma uma promessa genérica em uma capacidade verificável.
Monitoramento, desempenho e troubleshooting
O Appwrite pode parecer saudável no Console enquanto um worker reinicia, o disco se aproxima do limite ou uma fila cresce. O monitoramento precisa combinar métricas do host, estado dos contêineres e testes externos da aplicação. Comece com CPU, memória disponível, swap, espaço livre, latência de disco, tráfego de rede e quantidade de reinícios.
Métricas que antecipam problemas
Configure alertas antes do limite crítico. Um conjunto inicial pode avisar quando o disco ultrapassar 75%, memória disponível ficar abaixo de 15% por dez minutos, swap crescer continuamente ou um contêiner reiniciar três vezes em 15 minutos. Para CPU, picos breves de 100% não são necessariamente um problema. Saturação contínua acompanhada de aumento da latência p95 indica falta de capacidade ou uma tarefa específica consumindo o host.
Use docker stats para uma inspeção rápida e docker compose ps para verificar serviços. No host, free -h, df -h, iostat e ss -s ajudam a separar memória, disco e conexões. Em produção, Prometheus com Node Exporter, Grafana ou um serviço externo pode manter histórico. Um monitor HTTP deve consultar um endpoint real a cada minuto, de preferência executando uma leitura simples, não apenas verificando se a porta 443 responde.
Exemplo: a API passa de 180 ms para 1,4 segundo apenas durante uploads. Se CPU está em 35%, mas I/O wait chega a 28%, trocar duas vCPUs adicionais provavelmente não corrige o gargalo. Primeiro investigue o disco, o volume de logs e a concorrência de processamento de arquivos.
Falhas comuns em produção
Erro 502 logo após iniciar a pilha pode indicar que os serviços internos ainda estão subindo, falta de memória ou falha de migração. Consulte os logs do serviço afetado antes de reiniciar tudo. Reinícios sem diagnóstico podem esconder a causa e repetir o problema na próxima carga.
Falhas em Functions costumam envolver imagem de runtime, limite de memória, tempo máximo ou acesso ao Docker. Teste uma Function mínima antes de culpar a aplicação inteira. Se builds deixam o disco cheio, remova artefatos obsoletos conforme a documentação e revise a retenção de imagens. Não execute docker system prune --all --volumes de forma automática, pois o comando pode apagar dados necessários.
Para atualizações, leia as notas da versão, faça backup, teste em homologação e programe uma janela. Atualize uma versão por vez quando houver migrações relevantes. Depois, repita cadastro, consulta, upload, Realtime e Function. Esse roteiro curto cobre caminhos que uma simples abertura do Console não valida.
Recomendações por perfil
A escolha da VPS deve acompanhar o risco do projeto, não apenas o número atual de usuários. Dois aplicativos com 500 usuários podem exigir máquinas diferentes se um armazena documentos pequenos e o outro processa vídeos ou executa Functions pesadas. Os perfis abaixo servem como ponto inicial e precisam ser revisados com telemetria.
Desenvolvedor solo e protótipo
Para estudo, demonstração ou MVP sem dados críticos, use 2 vCPUs, 4 GB de RAM e 60 GB de SSD. Limite a quantidade de Functions concorrentes, evite armazenar arquivos grandes e monitore o disco semanalmente. Uma swap pequena ajuda durante builds, mas o ambiente pode ficar lento quando banco e runtime competem por memória. Mantenha um domínio de testes separado e faça ao menos um backup diário dos dados que não podem ser recriados. Esse perfil aceita interrupções e manutenção manual, mas ainda precisa de TLS, atualizações do sistema e chaves SSH. Se o uso de memória permanecer acima de 80%, migre para 8 GB antes de abrir o produto ao público.
Equipe pequena e produto em validação
Para uma equipe de dois a oito desenvolvedores com usuários reais, comece com 4 vCPUs, 8 GB de RAM e 120 GB de SSD ou NVMe. Separe produção e homologação, mesmo que a homologação use uma VPS menor. Configure monitoramento externo, alertas de disco e backups enviados a outro provedor ou região. Teste restauração pelo menos a cada três meses. A equipe deve registrar a versão do Appwrite, alterações no Compose e procedimento de atualização. Se uploads crescerem 3 GB por dia, 120 GB podem durar pouco mais de um mês quando banco, imagens e logs compartilham o disco. Nesse caso, planeje storage externo ou expansão antes de atingir 75% da capacidade.
Produção com usuários e funções
Para uma aplicação comercial com Realtime, uploads e Functions frequentes, considere 8 vCPUs, 16 GB de RAM e 250 GB de NVMe como base de avaliação. A configuração final depende de benchmark com a carga real. Defina RPO e RTO, mantenha cópias externas e automatize testes de saúde. Reserve capacidade para um pico de pelo menos duas vezes a carga normal ou documente como ampliar recursos rapidamente. Quando banco, arquivos e execução competirem pelo mesmo disco, separe componentes de forma gradual, seguindo uma arquitetura suportada. Uma segunda instância só melhora disponibilidade se houver balanceamento, persistência compartilhada e tratamento correto de sessões e filas. Duplicar a VPS sem esse desenho pode aumentar a complexidade sem remover o ponto único de falha.
Continue lendo
Perguntas frequentes
Qual é a configuração mínima para instalar Appwrite self-hosted?
Uma VPS com 2 vCPUs, 4 GB de RAM e cerca de 60 GB de SSD pode atender desenvolvimento, homologação e protótipos pequenos. Essa configuração oferece pouca margem para Functions concorrentes, uploads grandes ou várias conexões Realtime. Para produção com usuários reais, 4 vCPUs, 8 GB de RAM e 100 a 120 GB de armazenamento formam um ponto de partida mais seguro. O consumo deve ser acompanhado por métricas, pois banco, workers, Redis, API e runtimes dividem os mesmos recursos. Memória constantemente acima de 85% ou swap frequente indica necessidade de ajuste.
SSD ou NVMe faz diferença no Appwrite?
NVMe pode reduzir latência em operações intensivas de banco, builds de Functions, processamento de arquivos e cargas com muitas gravações simultâneas. A diferença tende a ser menor em projetos pequenos, nos quais CPU, memória ou rede são o gargalo principal. O tipo de disco também não compensa uma unidade cheia ou com desempenho compartilhado inconsistente. Mantenha pelo menos 25% de espaço livre e monitore I/O wait. Antes de migrar apenas pelo rótulo NVMe, execute um teste com consultas, uploads e Functions representativos da aplicação e compare latência p95, taxa de escrita e tempo de build.
É possível usar Appwrite self-hosted sem Docker?
O método oficial de self-hosting é baseado em Docker e Docker Compose, que organizam os vários serviços necessários à plataforma. Uma instalação manual fora desse modelo aumenta bastante a complexidade de dependências, redes, filas, banco, runtimes e atualizações, além de se afastar do caminho documentado. Para produção, o mais seguro é usar os arquivos e procedimentos oficiais da versão escolhida. Kubernetes ou outras formas de orquestração exigem conhecimento adicional e validação de compatibilidade. Se a equipe não domina Docker, primeiro pratique criação de volumes, leitura de logs, atualização de imagens e restauração em homologação.
Como fazer backup do Appwrite em uma VPS?
O backup precisa incluir uma cópia consistente do banco de dados e os volumes persistentes usados por uploads, configurações, certificados, Functions e builds, conforme o arquivo Compose da versão instalada. Envie as cópias para um destino externo à VPS e aplique criptografia e retenção. Snapshots do provedor podem complementar a estratégia, mas não devem ser a única camada. Defina também RPO e RTO. A cada trimestre, restaure o material em uma VPS temporária e valide autenticação, documentos, permissões, arquivos e execução de uma Function. Sem esse teste, não há confirmação de que o backup é recuperável.
Appwrite self-hosted escala apenas aumentando a VPS?
Aumentar CPU, RAM e disco é a forma mais simples de ganhar capacidade no início, mas não resolve todos os gargalos. Uma aplicação limitada por armazenamento, consultas ineficientes ou Functions pesadas pode continuar lenta em uma máquina maior. Antes do upgrade, observe CPU, memória, I/O wait, latência p95, filas e reinícios de contêineres. Em estágios mais avançados, pode ser necessário separar armazenamento, banco ou execução, desde que a arquitetura escolhida seja suportada e testada. Alta disponibilidade também exige balanceamento, persistência adequada e recuperação planejada. Apenas clonar a VPS não cria um cluster funcional.
Como atualizar o Appwrite self-hosted sem perder dados?
Leia as notas da versão, confirme requisitos e faça backup antes de alterar imagens ou arquivos Compose. Reproduza a atualização em homologação usando uma cópia sanitizada dos dados e registre o tempo das migrações. Em produção, fixe a versão desejada, programe uma janela e evite usar a tag `latest`. Após subir os serviços, verifique logs e teste cadastro, autenticação, leitura de documentos, upload, Realtime e Functions. Mantenha o arquivo Compose anterior e um plano de recuperação. Se a versão introduzir migrações irreversíveis, voltar apenas a imagem pode não funcionar, por isso a restauração do banco precisa estar documentada.
Fontes consultadas
- Appwrite Docs, Self-hosting · coletado em 03/11/2026
- Appwrite Docs, Production · coletado em 03/11/2026
- Docker Docs, Install Docker Engine on Ubuntu · coletado em 03/11/2026
- Docker Docs, Configure logging drivers · coletado em 03/11/2026