Base de Conhecimento

AnythingLLM na VPS: IA com os documentos da empresa

  • anythingllm, ia, docker, vps, lgpd
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: AnythingLLM na VPS: IA com os documentos da empresa

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.

Esta resposta lhe foi útil?

Artigos Relacionados