Appwrite na VPS: backend próprio para seus apps
Login, bancos, arquivos e functions no seu servidor: como instalar o Appwrite 2.7 com o instalador oficial, restringir o cadastro do Console, ligar o HTTPS e atualizar.
Por Redação Eleven Host · @robson.direitodigital · 21 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o guia: Appwrite na VPS: backend próprio para seus apps Arte: Eleven Host
Appwrite na VPS é instalar num servidor próprio o backend de código aberto que reúne login de usuários, bancos de dados, armazenamento de arquivos e functions, com os dados dos seus apps no ambiente que você administra.
Em 21/11/2026, a versão estável mais recente do Appwrite era a 2.7.4, publicada em 19/11/2026. O alerta alto CVE-2026-89036 afetava versões antes da 2.0.0 e foi corrigido nela: instale a versão mais nova, com a tag fixa, e acompanhe os alertas.
O que é o Appwrite
O README do repositório oficial descreve o Appwrite como uma plataforma de código aberto para criar e escalar aplicativos. Entre os produtos listados estão Auth (cadastro e login), Databases, Storage (arquivos), Functions, Sites, Messaging e Realtime. Ele pode ser usado na nuvem gerenciada do projeto ou instalado na própria infraestrutura.
Segundo a documentação, ele roda em qualquer sistema com Docker e também em Kubernetes, com um Helm chart oficial.
Licença
O arquivo LICENSE traz a licença BSD de 3 cláusulas, que é permissiva, desde que o aviso de copyright seja mantido nas cópias e o nome dos autores não seja usado para promover versões derivadas.
Uma instalação própria permite criar uma organização, e as outras contas entram nela por convite, segundo a página de instalação.
Para quem serve instalar no próprio servidor
A documentação indica a instalação própria para quem quer controle da infraestrutura e a nuvem gerenciada para equipes sem experiência em DevOps. Recomendamos considerar o Appwrite num servidor quando um desenvolvedor ou uma agência cria apps ou sites para clientes e quer o backend num ambiente próprio, com alguém para manter atualizações e cópias.
Uma VPS é um servidor virtual em que você instala o que precisa; o que é e como escolher uma está em O que é servidor VPS: guia simples para iniciantes. Se o front-end do app for em React, a publicação dele num servidor aparece em React na VPS: como publicar seu app com Nginx.
Servidores virtuais privados, as VPS, estão no catálogo da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver VPS
Requisitos mínimos
A página de instalação pede, no mínimo:
- 2 núcleos de CPU;
- 4 GB de memória RAM;
- 2 GB de swap;
- um sistema operacional que rode Docker;
- Docker CLI no servidor e Docker Compose versão 2.
Os comandos abaixo partem de um servidor com o Docker e o Docker Compose instalados conforme a documentação do Docker.
Versão atual e alertas de segurança
A imagem oficial fica no Docker Hub como appwrite/appwrite. Em 21/11/2026, as tags 2.7.4, 2.7 e latest tinham sido atualizadas em 19/11/2026. Pelas notas, a 2.7.4 é uma versão de manutenção da linha 2.7, e elas pedem backup antes de atualizar.
A página de alertas do repositório não tinha nenhum alerta publicado em 21/11/2026. No banco de alertas do GitHub, há um de gravidade alta, o CVE-2026-89036, ainda não revisado pelo GitHub: usuários autenticados com permissão de escrever functions ou sites podiam executar comandos no worker de builds. Ele afetava versões antes da 2.0.0 e foi corrigido nela.
Recomendamos acompanhar as versões novas e os alertas do projeto.
Como instalar com o instalador oficial
Antes de começar, recomendamos criar um subdomínio, como api.exemplo.com.br, com registro A apontando para o servidor. O certificado HTTPS automático depende de um domínio público apontado para a instância, explica a documentação de certificados.
O instalador abre um assistente web na porta 20080. Num servidor remoto, a documentação manda liberar essa porta no firewall ou no grupo de segurança e fechá-la depois da instalação. Como o assistente roda em HTTP, recomendamos liberar a 20080 só para o seu próprio IP e só durante a instalação.
Um exemplo de comando, para conferir no seu servidor. Ele é o da documentação, que mostra a tag 2.7.2; aqui com a 2.7.4, a mais recente em 21/11/2026 (confira a tag atual na página de versões):
docker run -it --rm \
--publish 20080:20080 \
--volume /var/run/docker.sock:/var/run/docker.sock \
--volume "$(pwd)"/appwrite:/usr/src/code/appwrite:rw \
--entrypoint="install" \
appwrite/appwrite:2.7.4
Os arquivos ficam na pasta appwrite, dentro da pasta onde o comando rodou. Com o comando aberto no terminal, acesse no navegador o endereço do servidor na porta 20080. O assistente segue quatro passos:
- Passo 1, o app: o Hostname (domínio ou IP em que a instância vai responder), a opção de usar HTTPS (ligada se o domínio usa HTTPS, inclusive atrás de proxy reverso) e o banco de dados, com PostgreSQL como padrão, MariaDB ou MongoDB.
- Passo 2, a segurança: o assistente gera uma chave secreta que cifra os dados sensíveis. Ela não aparece de novo depois desse passo: copie e guarde antes de avançar.
- Passo 3, a conta: o e-mail e a senha de acesso ao Console.
- Passo 4, a revisão: revisão das escolhas e o botão Install.
Terminada a instalação, a documentação manda abrir o hostname ou o IP no navegador e criar o primeiro projeto. Os comandos de gerenciamento rodam dentro da pasta appwrite:
cd appwrite
docker compose stop
docker compose start
Atenção: docker compose down -v remove a instalação e apaga todos os dados de forma permanente, avisa a documentação.
Instalação manual
A mesma página tem um gerador do docker-compose.yml e do .env, que vão para uma pasta appwrite; no .env, a documentação pede ao menos valores únicos para _APP_OPENSSL_KEY_V1 e _APP_EXECUTOR_SECRET antes de subir com docker compose up -d --remove-orphans.
O que configurar no .env
As variáveis ficam no arquivo .env da pasta appwrite. Entre as que a página de variáveis de ambiente descreve:
_APP_ENV: ambiente do servidor; o padrão da página é development, e ela manda usar production ao publicar. Confira se está assim no seu arquivo._APP_DOMAIN: domínio do Appwrite; com um domínio público, o certificado é emitido de forma automática._APP_OPENSSL_KEY_V1: chave que cifra arquivos e dados sensíveis, como chaves de API. A página de segurança pede defini-la logo depois de instalar, porque trocá-la depois faz perder senhas, segredos OAuth e chaves de API existentes._APP_EXECUTOR_SECRET: segredo da comunicação com o executor das functions, que a documentação manda trocar.
Quem pode criar conta no Console
A página de segurança lista três formas de restringir o Console. Com _APP_CONSOLE_WHITELIST_ROOT, ligado por padrão, só um usuário usa o formulário de cadastro, e os demais entram por convite. Também dá para limitar o cadastro a e-mails com _APP_CONSOLE_WHITELIST_EMAILS ou a endereços IP com _APP_CONSOLE_WHITELIST_IPS, em listas separadas por vírgula.
Depois de editar o arquivo, segundo a documentação, a mudança se aplica e as variáveis carregadas se conferem com estes comandos:
docker compose up -d
docker compose exec appwrite vars
HTTPS e certificado
Pela documentação de certificados, o Appwrite emite o certificado com o Let's Encrypt, pelo desafio HTTP. As condições são um domínio público apontado para o servidor, o _APP_ENV em production, um e-mail válido em _APP_SYSTEM_SECURITY_EMAIL_ADDRESS (o padrão é um endereço do projeto, e a página recomenda trocar pelo seu) e as portas 80 e 443, porque outras portas não funcionam para isso.
Com o registro DNS já apontando para o servidor, a emissão começa ao visitar o domínio principal, definido em _APP_DOMAIN. Para pedir à mão, a página mostra:
docker compose exec appwrite ssl
docker compose exec appwrite ssl domain="api.exemplo.com.br"
A variável _APP_OPTIONS_ROUTER_FORCE_HTTPS, ligada por padrão, redireciona o HTTP para o HTTPS, só nas portas 80 e 443.
Como configurar o e-mail SMTP
Sem SMTP, o Appwrite não envia e-mail: com _APP_SMTP_HOST vazio, todo envio fica desligado. A página de e-mail liga essa configuração à verificação de conta e aos links mágicos de login, e cita também a recuperação de senha e os convites de equipe. Um exemplo com os nomes da documentação, para trocar pelos dados do seu provedor:
_APP_SMTP_HOST=smtp.seuprovedor.com.br
_APP_SMTP_PORT=587
_APP_SMTP_SECURE=tls
_APP_SMTP_USERNAME=usuario-do-provedor
_APP_SMTP_PASSWORD=senha-do-provedor
_APP_SYSTEM_EMAIL_ADDRESS=noreply@exemplo.com.br
O remetente deve ser um endereço que o seu SMTP tem permissão de usar, para reduzir a chance de cair no spam, orienta a página. A mudança entra com docker compose up -d.
Dados dos usuários do app
Nome, e-mail e arquivos enviados pelos usuários dos seus apps podem ser dados pessoais. Recomendamos coletar só o necessário, restringir quem acessa o Console e manter as cópias de segurança protegidas.
Checklist do Appwrite na VPS
- tag de versão fixa e atual, sem latest;
- subdomínio apontado antes da instalação;
- porta 20080 fechada depois do assistente;
- chave secreta e .env guardados fora do servidor;
- _APP_ENV em production e e-mail de certificado trocado;
- cadastro do Console restrito;
- SMTP configurado e testado com uma recuperação de senha;
- backup de banco, volumes e .env conferido.
Como atualizar e fazer backup
A página de atualizações começa pelo backup. Depois, da pasta que contém appwrite, roda-se o mesmo comando da instalação com --entrypoint="upgrade" e a tag de destino, sem latest em produção. Em seguida, a documentação confere as versões dos contêineres e roda a migração:
docker ps | grep appwrite/appwrite
cd appwrite
docker compose exec appwrite migrate
Entre versões minor, a regra é passar pelo último patch de cada uma, e a documentação recomenda testar a migração numa instância fora de produção.
Para o backup, a documentação lista o banco de dados, os volumes (arquivos enviados, código das functions, builds, sites e certificados) e o arquivo .env, que tem um comando próprio:
cp .env .env.backup.$(date +"%Y%m%d")
A página pede desligar o Appwrite antes de copiar os volumes, guardar a _APP_OPENSSL_KEY_V1 (sem o valor exato, os dados cifrados ficam inacessíveis depois de restaurar), restaurar só numa instalação nova e testar a restauração com cópias cifradas e fora do servidor. Para o banco, recomendamos a ferramenta de cópia do banco escolhido na instalação, conforme a documentação dele.
Uma lista dos projetos do console
Recomendamos anotar cada projeto criado, o app que ele atende e quem da equipe tem acesso.
Domínio registrado na Eleven Host conta com DNS gerenciado grátis na rede da Cloudflare, com painel na área do cliente. Buscar domínio
Perguntas frequentes
O Appwrite é de código aberto?
O código é aberto, sob a licença BSD de 3 cláusulas. A documentação cita uma oferta enterprise para conformidade e suporte dedicado.
Qual banco de dados o Appwrite usa?
No instalador, o padrão é o PostgreSQL, com MariaDB e MongoDB como opções.
Posso perder dados ao trocar a _APP_OPENSSL_KEY_V1?
Sim. Segundo a página de segurança, trocar a chave depois da instalação faz perder senhas, segredos OAuth e chaves de API existentes.