AnythingLLM na VPS: IA com os documentos da empresa
AnythingLLM v1.19.0: licença MIT, versão Docker com multiusuário, requisitos oficiais, instalação na ordem, HTTPS, senha, telemetria, backup e atualização.
Por Redação Eleven Host · @robson.direitodigital · 13 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o tutorial: AnythingLLM na VPS: IA com os documentos da empresa Arte: Eleven Host
AnythingLLM na VPS é uma forma de manter no seu próprio servidor um aplicativo de IA para conversar com os documentos da empresa. Veja o que ele é, a licença MIT, os requisitos oficiais, a instalação com Docker, o HTTPS e os cuidados com os dados.
Atualizado em 13/11/2026. Na data deste texto, a versão estável mais nova é a v1.19.0, publicada em 26/10/2026. Os blocos marcados como exemplo não foram executados: confira cada um no seu servidor antes de usar.
O que é o AnythingLLM
O AnythingLLM é um aplicativo de IA mantido pela Mintplex Labs. Você envia documentos, organiza em espaços de trabalho (workspaces) e conversa com o conteúdo deles, no modelo conhecido como RAG. Ele traz também agentes de IA, uma API e um widget de chat embutível.
O aplicativo funciona com dezenas de provedores de modelos de linguagem (LLM) e com vários modelos de embedding e bancos vetoriais, e a escolha é feita no primeiro acesso. O código é licenciado sob a MIT. Há também uma instância hospedada e paga da Mintplex Labs.
Se você escolher um provedor externo de LLM ou de embedding, as perguntas e os trechos dos documentos são enviados a esse provedor. Eles saem da VPS, e o custo desse provedor é cobrado à parte.
Para entender o que é uma VPS antes de seguir, o guia completo de servidor VPS explica o básico.
Desktop ou Docker
Há uma versão Desktop, para Mac, Windows e Linux, e uma versão Docker, própria para servidor. Alguns recursos existem só na versão Docker: o modo multiusuário com permissões, os temas de cor com marca própria (white-label) e o widget de chat embutível. Para um login por pessoa, é a versão Docker.
Para quem serve
São exemplos de uso, sem promessa de resultado: uma equipe que quer consultar manuais internos, contratos e relatórios por perguntas em vez de abrir arquivo por arquivo, ou uma empresa que quer manter os arquivos dos documentos num servidor próprio.
Requisitos oficiais
Para a instalação Docker, a página de requisitos do AnythingLLM indica o mínimo abaixo:
- memória RAM: 2 GB;
- processador: 2 núcleos com suporte a AVX2, que a documentação trata como o único requisito rígido de hardware;
- disco: 5 GB.
Há uma divergência na documentação: o arquivo HOW_TO_USE_DOCKER.md do repositório fala em disco mínimo de 10 GB. Ao planejar o espaço, vale pensar no maior valor. O banco padrão é o SQLite, e a documentação de nuvem sugere o PostgreSQL só para escalar na horizontal. A aplicação responde na porta 3001.
O AVX2 é um recurso do processador. Antes de contratar, confirme no atendimento da Eleven Host, em português do Brasil, pela área do cliente e por tickets, se o plano escolhido atende a esse requisito.
Modelo local é outro assunto. Desde a v1.19.0, a imagem Docker traz um LLM embutido, desligado por padrão e ativado com -e ENABLE_BUILT_IN_LLM=true. Ele pede memória para o modelo escolhido além do mínimo acima, e cada modelo ocupa vários GB a mais de disco. A documentação recomenda fortemente uma GPU, e não há número oficial por modelo.
Mensalidades de VPS da Eleven Host ficam na loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Instalação com Docker, na ordem
A ordem importa: o Docker vem antes de tudo, a pasta de dados e o arquivo .env vêm antes do docker run, e a senha do aplicativo vem antes de ligar o domínio.
Primeiro, instale o Docker no servidor, seguindo a documentação do próprio Docker para o seu sistema. Segundo, baixe a imagem. A página local usa a tag latest, e a de nuvem usa master ao atualizar, então confira na documentação do AnythingLLM qual vale na hora de instalar:
docker pull mintplexlabs/anythingllm:latest
Terceiro, crie a pasta de dados e o .env e suba o container. O comando do repositório, para Linux e macOS, é este (mais abaixo há uma variação para VPS; rode só um dos dois docker run):
export STORAGE_LOCATION=$HOME/anythingllm && \
mkdir -p $STORAGE_LOCATION && \
touch "$STORAGE_LOCATION/.env" && \
docker run -d --rm -p 3001:3001 \
--cap-add SYS_ADMIN \
-v ${STORAGE_LOCATION}:/app/server/storage \
-v ${STORAGE_LOCATION}/.env:/app/server/.env \
-e STORAGE_DIR="/app/server/storage" \
mintplexlabs/anythingllm
A montagem -v ${STORAGE_LOCATION}:/app/server/storage é a que guarda os dados no servidor. Sem ela, tudo se perde quando o container é reiniciado. A permissão --cap-add SYS_ADMIN é ampla e está ali porque a raspagem de páginas web usa o Chromium em modo sandbox. A imagem roda com o usuário 1000:1000: em caso de erro de permissão, a documentação indica sudo chown -R 1000:1000 ${STORAGE_LOCATION} e desaconselha o chmod -R 777.
O que muda numa VPS
O comando oficial usa --rm, que remove o container ao parar, e não tem política de reinício. Numa VPS, recomendamos trocar por --restart unless-stopped, dar um nome ao container e publicar a porta só no endereço local, para que o acesso externo passe pelo proxy. Para usar esta variação, rode antes apenas o export, o mkdir e o touch do comando acima, sem o docker run oficial. Um exemplo, a conferir no seu servidor:
docker run -d --name anythingllm --restart unless-stopped -p 127.0.0.1:3001:3001 \
--cap-add SYS_ADMIN \
-v ${STORAGE_LOCATION}:/app/server/storage \
-v ${STORAGE_LOCATION}/.env:/app/server/.env \
-e STORAGE_DIR="/app/server/storage" \
mintplexlabs/anythingllm
Com a porta só no endereço local, o primeiro acesso pode ser feito por um túnel SSH até o seu computador. Um exemplo, com dados fictícios:
ssh -L 3001:127.0.0.1:3001 usuario@203.0.113.10
Depois, abra http://localhost:3001 no seu computador e faça o onboarding: LLM, embedder e banco vetorial.
Senha e multiusuário no primeiro acesso
Antes de abrir ao público
O comando oficial sobe o AnythingLLM sem senha. Até a proteção ser ligada, quem alcançar a porta 3001 entra na instância. Por isso, recomendamos ativar a senha ou o modo multiusuário logo no primeiro acesso, antes de ligar o domínio.
A documentação de segurança descreve dois caminhos. Para uma instância de um usuário só, ligue a opção Password Protect Instance e defina a senha, que depois pode ser trocada ou desligada. Para uma equipe, ligue Enable multi-user mode e crie o usuário e a senha do primeiro administrador. A sessão é encerrada, e você entra com o novo login.
Uma atenção: depois de ligado, o modo multiusuário não volta para o usuário único. Os papéis são três: o Admin pode tudo, o Manager vê os workspaces sem mexer em LLM, embedder nem banco vetorial, e o Default só conversa nos workspaces em que foi incluído.
Domínio e HTTPS
Com a senha definida, é hora do endereço. A documentação de nuvem diz que se deve usar um proxy reverso, como o Nginx, com um certificado TLS do Let's Encrypt. O domínio precisa apontar para o IP da VPS antes de emitir o certificado. Para domínios registrados conosco, o DNS gerenciado grátis na rede da Cloudflare fica no painel da área do cliente.
O exemplo oficial de Nginx traz linhas importantes. O proxy_pass aponta para o aplicativo local. Existe um bloco à parte para o WebSocket dos agentes, porque agentes e respostas em streaming precisam de WebSocket e de tempo de espera longo. As linhas-chave são estas:
proxy_pass http://localhost:3001;
location ~* ^/api/agent-invocation/(.*) {
proxy_set_header Connection "Upgrade";
proxy_read_timeout 605;
proxy_buffering off;
O restante do bloco está na página oficial de nuvem. Para o certificado, uma opção é o plugin do Certbot para Nginx, com o Nginx e o Certbot instalados e o bloco server do domínio já criado, e o artigo Certbot na VPS: SSL grátis do Let's Encrypt no Nginx mostra os passos. Um exemplo de comando, com domínio fictício, a conferir no seu servidor:
sudo certbot --nginx -d anythingllm.exemplo.com
Telemetria e navegação web dos agentes
A telemetria anônima de uso vem ligada por padrão. O README diz que ela coleta, por exemplo, o provedor e o modelo de LLM e o momento em que um chat é enviado, sem o conteúdo. Para desligar, acrescente a linha abaixo ao .env da pasta de dados ou use a opção Privacy da interface:
DISABLE_TELEMETRY=true
Desde a v1.16.2, a navegação web dos agentes vem ligada por padrão. Vale avaliar desligá-la se os agentes não precisam da internet.
Atualização
Como os dados ficam na pasta do servidor, a atualização oficial consiste em baixar a imagem nova e subir o container outra vez, com as mesmas montagens, e os dados persistem entre as recriações.
Com o container nomeado do exemplo, o caminho é parar o container, fazer a cópia da pasta de dados (o exemplo está na seção Backup, logo abaixo), remover o container, baixar a imagem e subir de novo. Um exemplo, a conferir no seu servidor:
docker stop anythingllm
docker rm anythingllm
docker pull mintplexlabs/anythingllm:latest
Depois, rode o docker run do exemplo outra vez, definindo o STORAGE_LOCATION de novo se a sessão do terminal for outra.
Backup
Os dados da versão Docker ficam na pasta ${STORAGE_LOCATION}, que no exemplo é $HOME/anythingllm, junto do .env. A estrutura de armazenamento descrita para o aplicativo Desktop inclui o banco anythingllm.db, os documentos, o cache de embeddings e o banco vetorial local, e a mesma organização é esperada no Docker.
Um caminho possível: parar o container, copiar a pasta inteira e subir de novo. O .env guarda as chaves de API dos provedores, então a cópia tem segredo dentro e merece o mesmo cuidado do original. Um banco vetorial externo tem backup próprio. Um exemplo:
docker stop anythingllm
tar czf anythingllm-dados.tar.gz -C $HOME anythingllm
docker start anythingllm
Cópia que fica só no mesmo servidor some junto com ele. O artigo Backup da VPS: como fazer cópia automática trata desse assunto.
Documentos com dados pessoais e a LGPD
Contratos, currículos e fichas de clientes podem trazer nomes e contatos, e a LGPD, a lei brasileira de proteção de dados, trata esse tipo de informação. Um aplicativo não garante conformidade sozinho. Recomendamos limitar quem acessa, definir com cuidado o provedor de LLM, já que ele recebe os trechos enviados, e tratar o assunto com quem cuida do jurídico do negócio.
O endereço do sistema
O domínio usado no proxy precisa existir antes do certificado.
Nomes livres aparecem na busca de domínio da loja da Eleven Host. Buscar domínio
Perguntas frequentes
O AnythingLLM é gratuito?
O código tem licença MIT. O custo de um LLM externo é à parte, e a instância hospedada da Mintplex Labs é paga.
Os documentos ficam só na minha VPS?
Os arquivos ficam no servidor, mas um provedor externo de LLM ou de embedding recebe as perguntas e os trechos dos documentos.
Dá para ter vários usuários?
Sim, na versão Docker, com o modo multiusuário, que não volta ao usuário único depois de ligado.
Como desligo a telemetria?
Com DISABLE_TELEMETRY=true no .env ou pela opção Privacy da interface.