Tutorial do Open WebUI: adicione ao Ollama uma interface web como a do ChatGPT

Conversar pelo terminal é prático, mas, para compartilhar com familiares ou colegas, você precisa de uma interface web. Open WebUI é uma das opções de código aberto mais populares. A interface é parecida com a do ChatGPT e oferece muitos recursos:

• Histórico de conversas, troca entre modelos e exibição de Markdown e código
• Envie documentos para o modelo responder com base neles (RAG integrado)
• Contas para vários usuários e gerenciamento de permissões
• Modelos personalizados (prompt do sistema e parâmetros)
• Compatível com Ollama e com APIs compatíveis com OpenAI

Instale com Docker (recomendado)

Se o Ollama já estiver instalado no host:

docker run -d --name open-webui \
  -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  --restart always \
  ghcr.io/open-webui/open-webui:main

Acesse http://localhost:3000. A conta criada na primeira vez será a administradora.

• --add-host=host.docker.internal:host-gateway: permite que o contêiner se conecte ao Ollama no host (necessário no Linux; o Docker Desktop já oferece suporte a esse nome).
• -v open-webui:/app/backend/data: mantém as contas, o histórico de conversas e as configurações.

Para executar o Ollama e o Open WebUI com Docker, use o exemplo do Compose em Execute o Ollama com Docker.

Instale com pip

Se não quiser usar Docker (requer Python 3.11):

pip install open-webui
open-webui serve

O endereço padrão é http://localhost:8080.

Não consegue se conectar ao Ollama?

Acesse Configurações de administrador → Conexões e confira o endereço da API do Ollama:

No Linux, o Ollama no host escuta apenas em 127.0.0.1 por padrão, então o contêiner talvez não consiga se conectar. Você pode definir OLLAMA_HOST como 0.0.0.0 (e restringir conexões externas pelo firewall) ou executar o Open WebUI com --network host. Nesse caso, o endereço passa a ser http://localhost:8080.

Uso básico

1. Escolha um modelo no canto superior esquerdo. Os modelos do Ollama que já foram baixados aparecem automaticamente.
2. O administrador também pode digitar o nome de um modelo no menu de modelos para baixá-lo (por exemplo, qwen3:8b).
3. O histórico de conversas fica na barra lateral esquerda.

Perguntas e respostas sobre documentos

Clique em + na caixa de conversa para enviar arquivos PDF, Word ou texto e, em seguida, pergunte sobre o conteúdo. O Open WebUI divide os documentos em trechos, gera embeddings e busca os trechos relevantes automaticamente.

Para usar o mesmo conjunto de documentos por mais tempo, crie uma base de conhecimento em Espaço de trabalho → Conhecimento e faça referência a ela com # durante a conversa.

Recomendamos trocar o modelo de embeddings por um modelo multilíngue em Configurações de administrador → Documentos (por exemplo, usando bge-m3 pelo Ollama). A busca em documentos em chinês terá resultados melhores. Veja a explicação em Embeddings de texto e RAG.

Modelos personalizados

Em Espaço de trabalho → Modelos → Novo, você pode configurar qualquer modelo com:

• Prompt do sistema (por exemplo, “Use sempre português brasileiro”)
• Parâmetros (temperature, tamanho do contexto)
• Uma base de conhecimento associada por padrão

Os modelos criados aparecem no menu de modelos de todos os usuários, por exemplo, “Assistente de atendimento” e “Revisor de código”.

Uso por várias pessoas

• Configurações de administrador → Usuários: por padrão, novos usuários ficam “Aguardando aprovação” após se cadastrar. Só podem usar o serviço depois que um administrador os aprovar.
• Você pode configurar grupos de usuários e quais modelos cada grupo pode usar.
• Para permitir o acesso de outras pessoas na rede local, peça que acessem http://IP-do-seu-computador:3000.

Para disponibilizar o serviço na internet, configure um proxy reverso HTTPS na frente dele e desative o cadastro público.

Atualização

docker pull ghcr.io/open-webui/open-webui:main
docker rm -f open-webui
# Execute novamente o comando docker run original; os dados no Volume não serão perdidos

Dúvidas comuns

A lista de modelos está vazia

O Open WebUI não consegue se conectar ao Ollama. Confira o endereço conforme a seção “Não consegue se conectar ao Ollama?” acima. Você pode testar dentro do contêiner:

docker exec open-webui curl -s http://host.docker.internal:11434/api/tags

As respostas estão lentas

O Open WebUI é apenas a interface. A velocidade depende do Ollama e do seu hardware. Consulte GPU e ajustes de desempenho.

Esqueci a senha de administrador

A senha de administrador fica no banco de dados dentro do Volume. A maneira mais simples é pedir a outro administrador que a redefina. Se houver apenas um administrador, consulte as instruções de redefinição de senha na documentação oficial do Open WebUI.

Atualizado 12 de outubro de 2026