Base de Conhecimento

Appwrite na VPS: backend próprio para seus apps

  • appwrite, vps, backend, docker, self-hosting
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Appwrite na VPS: backend próprio para seus apps

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.

Esta resposta lhe foi útil?

Artigos Relacionados