Página inicial da VPSie

Voltar para a base de conhecimento

Aprenda a criar uma instância de AnythingLLM de alto desempenho no seu servidor em nuvem VPSie. O AnythingLLM oferece um espaço de trabalho web completo e multiusuário para IA local, análise de documentos (RAG) e fluxos de trabalho de agentes LLM personalizados.

Prepare sua instância VPSie

  • Crie uma Conta: Registre-se no Portal do Cliente VPSie.
  • Adicione Fundos à Sua Conta: Acesse a seção de Faturamento no portal para adicionar fundos ou configurar métodos de pagamento.
  • Implante um Servidor: Crie uma VM Linux com Ubuntu 24.04 / 26.04 LTS ou Debian 12 / 13, com pelo menos 2 vCPUs e 2 GB de RAM.

Atualizar sistema e instalar Docker

Entre no seu servidor VPSie via SSH ou pelo Console HTML5 integrado da VPSie.

Atualize os repositórios do sistema:

sudo apt update && sudo apt upgrade -y

Instale os pré-requisitos:

sudo apt install -y ca-certificates curl gnupg lsb-release

Instale o Docker Engine oficial e o plugin Compose:

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

Configurar pasta e permissões

Para evitar loops de falha do container causados por incompatibilidade de permissões de arquivo, crie o diretório de armazenamento do host e o arquivo de ambiente inicial com permissões de escrita:

Crie os diretórios do projeto e de armazenamento:

mkdir -p ~/anythingllm/storage
cd ~/anythingllm

Crie o arquivo de ambiente vazio:

touch .env

Conceda permissões de escrita para o mapeamento de usuário não root do Docker:

chmod -R 777 storage
chmod 666 .env

Crie o arquivo Docker Compose e inicie o AnythingLLM

Crie sua configuração do compose:

nano docker-compose.yml

Cole a seguinte configuração:

services:
  anythingllm:
    image: mintplexlabs/anythingllm:latest
    container_name: anythingllm
    ports:
      - "3001:3001"
    cap_add:
      - SYS_ADMIN
    volumes:
      - ./storage:/app/server/storage
      - ./.env:/app/server/.env
    environment:
      - STORAGE_DIR=/app/server/storage
    extra_hosts:
      - "host.docker.internal:host-gateway"
    restart: unless-stopped

Inicie o AnythingLLM iniciando o contêiner:

docker compose up -d

Verifique se o status do contêiner exibe Up (não Restarting):

docker compose ps

Concluindo o assistente de configuração web do AnythingLLM

Assim que o contêiner Docker do AnythingLLM estiver ativo, você pode concluir a configuração inicial diretamente no seu navegador web.

1. Abra seu navegador web e acesse http://<YOUR_VPSie_IP>:3001.

2. Clique no botão branco Get Started na tela de boas-vindas.

AnythingLLM na VPSie

Instale o Ollama localmente

Execute o script de instalação oficial do Ollama:

curl -fsSL https://ollama.com/install.sh | sh

Isso instala o Ollama como um serviço systemd e o inicia automaticamente.

Verifique se o serviço está ativo:

systemctl status ollama

Baixe um modelo de chat e um modelo de embedding:
O AnythingLLM requer dois modelos: um para chat e um para embeddings (usado para Q&A/RAG de documentos). Pular o modelo de embedding faz com que o upload de documentos falhe silenciosamente.

ollama pull llama3.2
ollama pull nomic-embed-text

Confirme se ambos os modelos foram baixados corretamente:

ollama list

Configure o Ollama para aceitar conexões do Docker

Por padrão, o Ollama se vincula apenas a 127.0.0.1, o que significa que aceita conexões apenas da máquina local, não de outros contêineres, incluindo o contêiner Docker do seu AnythingLLM. Você precisa alterar isso para escutar em todas as interfaces (0.0.0.0).

Abra o arquivo de override do systemd:

sudo systemctl edit ollama.service

Isso abre o nano (ou seu editor padrão) em um arquivo de override drop-in. Tudo acima da linha ### Edits below this comment will be discarded é onde suas alterações devem ser feitas.

Adicione a variável de ambiente. No topo da seção editável, adicione:

[Service]
Environment="OLLAMA_HOST=0.0.0.0:11434"

Salve o arquivo:

1. Pressione Ctrl+O

2. Pressione Enter para confirmar o nome do arquivo

3. Pressione Ctrl+X para sair

Agora continue com a verificação:

cat /etc/systemd/system/ollama.service.d/override.conf

Depois recarregue e reinicie:

sudo systemctl daemon-reload
sudo systemctl restart ollama

Depois confirme se ele está realmente escutando em todas as interfaces:

sudo ss -tlnp | grep 11434

Você deve ver 0.0.0.0:11434 na saída, e não 127.0.0.1:11434.

Depois de confirmar, teste de dentro do container AnythingLLM:

sudo docker exec -it anythingllm curl http://host.docker.internal:11434

Agora, volte para a tela Preferência de LLM no navegador

AnythingLLM
  • Selecione Ollama como provedor de LLM.
  • Em Ollama Base URL, substitua http://127.0.0.1:11434 por: http://host.docker.internal:11434
  • No modelo Ollama, clique no menu suspenso e selecione llama3.2:latest; não use nomic-embed-text:latest.
  • Clique em Next.
AnythingLLM

Se você ainda tiver problemas ao identificar provedores de IA:

Vá para Settings → AI Providers → LLM

Lá, insira novamente:

Provider: Ollama
Base URL: http://host.docker.internal:11434
Chat Model: llama3.2:latest

Clique em Save e aguarde a confirmação de sucesso (uma notificação toast, geralmente no canto inferior direito) antes de navegar para outra página.

Voltar para a base de conhecimento